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SECTION 1 



INTRODUCTION 



This Programmers Reference Manual for the Fortran Support Package (FSP) is pro- 
vided by Sanders in support of its GRAPHICS 7 interactive display terminal. 

1.1 SUBROUTINE CONCEPT 

FSP is a collection of 62 Fortran-callable subroutines. The routines 
require little knowledge of the GRAPHIC 7 terminal, yet allow the user 
maximum utilization of its interactive capabilities. 

1.2 HOST COMPUTERS 

FSP is designed to run in any host computer which supports Fortran and has 
a minimum word length 'of 16 bits. The actual hardware method by which the 
GRAPHIC 7 terminal is connected to the host is of no concern to FSP since it is 
1/0 independent. I/O considerations such as parallel or serial interfaces, half 
or full-duplex, selector or multiplexer channels, etc., are incorporated in the 
customer-supplied I/O driver and hardware interface, leaving FSP computer 
Independent. Depending on the host computer, Sanders, by special request, will 
supply the I/O driver (software). 

1.3 STRUCTURE 

FSP employs the distributed processing approach, because it requires and 
makes extensive use of the Graphic Control Program Enhanced (GCP+) , which is 
resident in read-only memory in the GRAPHIC 7. 

Figure 1-1 shows that the application program uses FSP by making calls to 
the various subroutines. FSP formats GCP+-compatible messages and transmits 
them to the GRAPHIC 7 terminal via the MSGOUT subroutine (provided by the cus- 
tomer) . GCP+ in the GRAPHIC 7 processes the message to produce the desired 
results. 

FSP also receives and interprets messages from GCP+ in response to a POLL 
request. These messages contain PHOTOPEN, keyboard, and PED* information. 

1.4 TSP/GCP-f LINK CONTROL 

As mentioned above, GCP+ sends messages to FSP only when polled. Each 
message (input or output) contains a header word to identify the message, then 
the remainder of the message. FSP may send a message to the GCP+ at any time. 



* - FED = position entry device 
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1.5 ERROR DETECTION /RECEIVING 



Errors generated in running FSP are detected and an error code is displayed 
in the upper left corner of the display screen. This error display area can be 
turned on or off (displayed or not displayed) by user calls to routines ENBERR, 
to turn error display on, or DSAERR to turn error display off. See Section 9 
for a more detailed description of these routines. 

Error detection is also available under program control. When the user 
calls to EVENT, the routine which polls the terminal for an event or request 
response, the routine sends back an event code indicating an error has been 
detected. The user can now call subroutine GETERR to retrieve the error code. 
See Section 18 for a detailed description of the GETERR routines « 

Error codes are defined in Appendix €• 
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SECTION 2 
FEATURES OF FSP 

The standard features of FSP are specified below: 

1. Fortran-callable subroutines. 

2. Distributed processing: Some features are performed in the host computer, 
others in the GRAPHIC 7 terminal. 

3. FSP is machine independent. 

4. Refresh paging mechanism for organizing refresh data. This includes refresh 
subroutine capability. 

5. Windowing of user data including: 

a. Data scaling: The conversion of user coordinates to refresh coordin- 
ates and vice versa. 

b. Image scissoring: Truncating portions of a display that extend be- 
yond the screen boundaries. 

6. Modifying images presently displayed (selective updating). 

7. Each copy of FSP in the host supports one GRAPHIC 7 controller with four 
CRT indicators, two keyboards, two trackballs or data tablets, two 
PHOTOPENs, conic generator, and 2D coordinate converter. 

8. ■ Operator interactions with application program: 

a. Alphanumeric keyboard 

b. Function keys 

c. Trackball, forcestick, or data tablet 

d. PHOTOPEN 

9. Generation of all refresh instructions including image generation commands 
(MOVE, DRAW, CIRCLE, POINT, TEXT). 

10. Smoothing of user data to minimize the number of coordinates necessary for 
presenting a continuous line. 

11. Local PED operation performed at the terminal, 
a. PED symbol locally updated at the terminal. 
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b. Symbol may be user defined or the default symbol. 

12. Local keyboard manipulations performed at the terminal. 

a. Characters typed directly into a refresh scratchpad. 

b. Scratchpad area can be edited from the keyboard. 

13. Local PHOTOPEN operations performed at the terminal. 

a. PHOTOPEN finder - The position of the PHOTOPEN on the screen is 
determined by the GCPH-, by flashing a grid pattern locating the 
PHOTOPEN position^ 

14. Mass transfer of existing refresh data to the terminal. This allows for 
off line generated refresh code to be passed directly to the GRAPHIC 7 
terminal and inserted into the refresh memory without any additional 
processing. 

15. All floating point arithmetic processing of FSP is done in the host com- 
puter. The GRAPHIC 7 GCP+ performs fixed point arithmetic. 

16. For inserting refresh code, two modes of operation exist: 

a. Initial or additional data. 

b. Editing data (selective updating). 

17. Hard copy capability. The application program can request that the image 
on the screen be hard copied on the Sanders 570 Hard Copy Unit. 

18. Displayed images can be rotated and translated on the CRT. Four subrou- 
tines exist for manipulating the 2D coordinate converter hardware option. 

19. All position data transmitted between host and GRAPHIC 7 is in screen 
coordinates. 
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SECTION 3 
FSP DISTRIBUTED PROCESSING 

This section describes how graphics tasks are distributed between FSP in the 
host and GCP+ in the terminal, 

3. 1 FSP Processing 

1. All floating point conversion. 

a) Scaling: conversion of user floating point coordinates to display 
coordinates. 

b) Windowing: zooming and offsetting. 

2. Scissoring: the clipping of off screen data. 

3. Smoothing: the removing of unneeded points in defining a continuous line. 

4. Formatting and transmitting the message to the GRAPHIC 7 terminal. 

5. Receiving and converting all messages from the GRAHPIC 7 terminal to a 
manageable form for Fortran. This includes converting screen coordinates 
to floating point user coordinates. 

6. Controls refresh file management, LAYOUT. 

3. 2 GCP+ Processing 

1. Receives messages from the host computer. 

2. Processes messages from the host computer. 

3. Handles FED manipulations and symbol. 

4. Finds the PHOTOPEN position on a blank screen. 

5. Displays alphanumeric keyboard inputs on the screen in a predefined 
scratch pad area. 

6. Handles editing of text displayed in the scratch pad. 

7. Formats all messages to the host computer. 

8. Services all display interrupts. 

9. Services all display peripheral devices. 
10. Performs validation test and diagnostics. 
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FSP SUBROUTINE LIBRARY 



The FSP subroutines can be categorized as follows; 
A. Setup Routines 



1. 


GSS4 


2. 


LAYOUT 


3. 


SCALE 


4. 


ENBBOX 


5. 


DSABOX 


6. 


ENBERR 


7. 


DSAERR 


8. 


THEEND 



B. Image Generation Routines 

1 . MOVE 

2. DRAW 

3. TEXT 

4. POINT 

5. CIRCLE 

6. REFDAT 

C. Page Management Routines 



1. 


ADDREF 


2. 


UPDATE 


3. 


ERASEP 


4. 


PICTUR 


5. 


REQMRK 


6. 


GETMRK 


7. 


MOVEIM 


8. 


COPYIM 



D. Status Routines 

1. CPARM 

2. DPARM 

3. STATUS 

4. LAMPON 

5. LAMPOF 

6. COLOR 

E. Event Routine 
1 . EVENT 
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Alphanumeric /Function Keyboard Routines 



1 . ENBPAD 

2 . DSAPAD 

3. GETTXT 

4. GETKEY 

G. Photopen Item Routines 

1 . ENBPEN 

2. DSAPEN 

3. ITEM 

4. GETPEN 

H. Photopen Scan Routines 

1 . ENBPXY 

2. DSAPXY 

3. REQPXY 

4. GETPXY 

I. Trackball/Forcestick/Data Tablet Routines 

1 . TBALL 

2. DISTB 

3. DTINIT 
4„ DTMODE 

5. REQTB 

6. GETTB 

J« Miscellaneous Routines 

1 . HCOPY 

2. REQIM 

3 . GETIM 

4. GETERR 

K. Packed Vector Routines 

1 . ENBPMD 

2. PDRAW 

3. PMOVE 

4. DSAPMD 

Le Coordinate Converter Routines 

1 « CCINIT 

2. CCVAL 

3« CCON 

4. CCOFF 

M. Image Control Routines 

1 . CLIP 
2 « SMOOTH 
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SECTION 5 



HARDWARE CONFIGURATIONS SUPPORTED 

FSP supports either one or two display stations. A display station may have 
the following equipment: 

• Monitor 

• Slave monitor 

• PHOTOPEN 

• Trackball or forcestick or data tablet 

• Alphanumeric /function keyboard 

• Hardcopy 

The basic FSP supports the following hardware in the terminal controller: 

• Memory configurations up to 128K 

• Character generator 

• Vector/position generator 

• Conic generator 

• 2D coordinate converter 
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SECTION 6 



PAGING CONCEPT 



A GRAPHIC 7 may be configured to have up to four 32K banks of memory for a total 
of 12 8K of memory. 

GCP+ and the memory required to support it occupies approximately 9K of space in 
memory bank 0 and leaves approximately 23K of space for the user's refresh program. 
The entire 32K in memory banks 1, 2, and 3 is available for refresh. The approximate 
total useable refresh space in a 128K system therefore is 119K. The following chart 
summarizes the amount of user refresh program space available for the various memory 
configurations : 

TOTAL MEMORY USER REFRESH SPACE 



8K 5K* ^^These memory configurations are exceptions to 

16K IIK* the above paragraph. For 8K systems, 2K of 

32K 23K memory is set aside to support options. For 

54K 55K 16K systems, 4K of memory is set aside to 

80K 71K support options. On systems where no present i 

96K 87K or future option support is needed, modifica- 

128K 119K tions can be made to FSP to increase user 

refresh space to 7K or 15K in 8K or 16K memory I 
systems. 



FSP uses a paging and mark approach wherein the following definitions are used: 
"Page" Definition 

• A page is a contiguous block of memory locations. 

• A page may range in size from 4 memory locations to 32K-4 memory locations. 

• A maximum of 255 pages may be defined. 

• A page is referred to by a numeric value which ranges from 1 to 255. 

• A page normally contains refresh commands generated by the various calls 
to FSP. 

• Pages are defined by a call to LAYOUT in the host but physically exist in 
the memory of the GRAPHIC 7. 

• A page may not cross bank boundaries. 

• Page 1 exists entirely in memory bank 0. 

• Page 1 is always refreshed and can be thought of as the "mainline" refresh 
program. 
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• Pages 2 and above are not always refreshed and may be thought of as refresh 
subroutines. 

"Mark" Definition 

• A mark is a relative pointer into a page. 

• Each page has a corresponding mark pointer associated with it. 

• Mark values range from 0 to 32K--4 
e.g. 

A mark value of 4 refers to the 5th memory location 
relative to the start of a page. 

• The length of a page is defined in terms of 16-bit words. 

The LAYOUT call (see paragraph 9.2) allows the caller to define Graphic pages 
(divide memory into sections) . 

The page and mark combination allows any memory location to be addressed by the 
FSP routines. 
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SECTION 7 
COORDINATE SYSTEM 



The user can define the limits of the coordinate system he will use by calling 
subroutine SCALE with parameters defining the lower left and the upper right coordin- 
ates of the screen. FSP converts these floating point coordinates to integer display 
coordinates as the various FSP routines are called* It is the display coordinates 
that are passed to the GCPH- program. Without a call to SCALE, the user coordinate 
system is the same resolution as the display coordinate system. The lower left point 
is defined as (0., 0-) and the upper right point as (+1023 .,+1023 , ). See paragraph 
9.3 for a detailed description of subroutine SCALE. 
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SECTION 8 



USE OF LABELLED COMMON 



FSP uses labelled common. The user should be careful not to use these common 
block names within his program. These common blocks and their dimensions are as 
follows : 

Common Block Name Common Block Length (Words) 



TERMS 




279 


COORD 




9 


PVMD 




9 


LAYOT 




516 


MA.ST 




5 


PERIPH 




6 


PER2 




2 


PEN 




1 


LMEM 




11 




Total 


838 



8- 



f 
( 



0 



V 



SECTION 9 
SETUP ROUTINES 

The following subroutines are described in this section: 
GSS4 - Initialize the terminal to FSP mode. 
LAYOUT - Define FSP memory layout in the GRAPHIC 7 terminal. 
SCALE - Define user coordinate system. 
ENDBOX - Turn border display on. 
DSABOX » Turn border display off. 
ENBERR - ^ Turn error display on. 
DSAERR - Turn error display off. 

THEEND - Terminate FSP mode. S 

c 

The purpose of the routines in this section is to set up and define the general i 
cha:tracteristics of the GRAPHIC 7. The GRAPHIC 7 is notified that it will be com- | 
municating with a host application program that is using the Fortran support package 
(FSE>) and is placed in FSP mode by the user's call to GSS4. The GRAPHIC 7 memory is 
allocated according to the specifications defined by the user in the call to LAYOUT. 
The viewable area or boundary (commonly called window) that the user specifies 
(by the call to SCALE) maps the user's coordinates to display coordinates and deter- 
mines what image generation routines are called. Only objects with coordinates 
wittiin this user defined viewing area are displayed. 

The status of FSP's error message area and border are controlled by the user's 
cairs to ENBERR and ENBBOX, which enable them to be displayable, and calls to DSABOX 
and DSAERR to turn them off. 

When the host application program has completed its task, it must call THEEND 
to tmotify the GRAPHIC 7 that it is no longer communicating with a FSP host applica- 
tion and to place it in teletypewriter emulation mode. 
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9 . 1 INITIALIZE THE TERMINAL TO FSP MODE 



NAME: GSS4 

FUNCTION: Initializes FSP. This must be the first FSP routine called. 
CALLING FORMAT: CALL GSS4 (lUNIT, IDUM, IFACE) 
DESCRIPTION OF PARAMETERS: 

lUNIT ^ Integer variable containing the logical unit # assigned to the 
GRAPHIC 7 1/0 driver o This value is supplied as an argument to 
subsequent G7INIT, G7TERMs MSGOUT, and MSGIN subroutine calls 
(see Section 22 for a more detailed description of these 
subroutines) . 

IDUM - Dummy argument (for expansion) 

IFACE ^ Integer variable containing the type of hardware interface between 
the host and the GRAPHIC 7 terminal. 

1 ^ Parallel 

2 = Serial 

DETAILED DESCRIPTION: 

In addition to reinitializing internal FSP variables, the following visuals 
can be observed: 

• The screen is cleared « The GSS4 routine causes the customer- 
supplied G7INIT routine described in paragraph 22.1 to be called 
as follows: 

CALL G7INIT (lUNIT) 

This subroutine is responsible for activating the system mode of 
GCP+. 

• A full screen border is placed on the screen to outline the dis- 
play able area. 

• A two digit ^*error message" is displayed in the upper left corner 
of the screen. A successful call results in "00" being displayed^ 
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9.2 DEFINE FSP MEMORY LAYOUT IN THE GRAPHIC 7 TERMINAL 



NAME: LAYOUT 

FUNCTION: Partitions the memory in the GRAPHIC 7 into pages. This routine 
must be the second FSP routine called (GSS4 is the first) . 

CALLING FORMAT: CALL LAYOUT (NPAGES, LNGARY) 

DESCRIPTION OF PARAMETERS: 

Three distinct functions can be performed by LAYOUT depending on the 
value of the NPAGES . 

NPAGES = 1 to 255 • . . User specifies memory layout 

=0 ... FSP automatically performs memory layout 

= -1 ... User requests a description of how FSP would 

allocate memory but no allocation is made. 

USER ALLOCATION 

NPAGES = An integer variable supplied by the caller indicating the number 
of graphic pages desired. Each element of the length array 
(LNGARY) contains the length in words of the corresponding 
graphic page. 

1 < NPAGES < 255 

LNGARY = An integer array supplied by the caller whose length is equal to 
NPAGES. Each element of the array must be filled in by the 
caller with the length in "words" of the corresponding page, i.e. 

LNGARY (1) = Length of page 1 
LNGARY (2) = Length of page 2 

LNGARY (NPAGES) = Length of page NPAGES 

The maximum size of page 1 is 23720 words; the maximum size of all other pages 
is 32763 words. 

AUTOMATIC ALLOCATION 

NPAGES = 0 (Supplied by caller and indicates automatic allocation 
requested. ) 

LNGARY = A four word integer array supplied by the caller and filled in by 
LAYOUT. LAYOUT automatically creates 1 to 4 graphic pages, 
depending on the installed memory configuration. The mark length 
values returned in LNGARY are as follows: 
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• 


8K,16K,32K systems 


LNGARY(l) 


= Length 


of page 1 






JjIN Vjillv JL \/L ) 


= -1 (r\r^ 
L \L1U 


pd.ge ^ QenneQy 






T NrARY ( 

ijiNVjrilvl J 


=s -1 f-nn 


page J uenneay 






T ■NTPAPY ^ A^ 
JUIMo-iiJXl \ He ) 


— ""i ySlO 


page H- uerxnea^ 


• 


64K systems 


LNGARY(l) 


= Length 


of page 1 






T MPAPY 9*^ 
ljiNVjriI\.l \ ^ ) 


l-itillgLn 


oi page Z 








Jl \l.L\J 


page 






T NHARY ^ A^ 

ijiNVjrriI\.l \ H- / 


— ± \,no 


page 4; 


• 


80K, 96K systems 


LNGARY(l) 


= Length 


of page 1 








ljeilgL.il 


ox page z 








as T r*" +" M 

-~ jjengtn 


OX page J 








1 v^no 


page 'I-; 


• 


128K systems 


LNGARY(l) 


= Length 


of page 1 






LNGARY(2) 


= Length 


of page 2 






LNGARY(3) 


~ Length 


of page 3 






LNGARY(4) 


= Length 


of page 4 



CONFIGURATION 

NPAGES = -l (Supplied by caller and indicates configuration request; 
no pages allocated.) 

LNGARY = A four word integer array supplied by the caller and filled in 
by LAYOUT. No pages are allocated and the data returned is the 
same as for the automatic allocation. 

DETAILED DESCRIPTION 

The memory of the GRAPHIC 7 must be divided into graphic pages by 
using the LAYOUT subroutine before the subroutines described in the 
remaining sections can be used. User pages are numbered starting at 1. 
Page 1 is the "mainline refresh" page and all graphic orders in it are 
displayed. Graphic orders in pages 2 through 255 are displayed only 
through calling the PICTUR subroutine (see paragraph 11.5). The mark 
values for each graphic page created by this call are set to zero. Pages 
are allocated starting at the lowest memory allowable location of the first 
32K memory bank and work upwards. A page is not allowed to cross 32K 
memory banks and LAYOUT will assign memory accordingly. If the user at 
some later time wishes to reallocate his pages, he must reinitialize the 
graphics package by calling GSS4, followed by a call LAYOUT. 
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Example 



C 

C ALLOCATE 20,200 WORDS OF THE 

C GRAPHIC 7 MEMORY 

C INTO 7 PAGES USING LAYOUT 



c 


WHERE 






c 


PAGE 


1 = 


10,000 WORDS 


c 


PAGE 


2 = 


2,000 WORDS 


c 


PAGE 


3 = 


200 WORDS 


c 


PAGE 


4 = 


1,500 WORDS 


c 


PAGE 


5 = 


1,500 WORDS 


c 


PAGE 


6 = 


3,000 WORDS 


c 


PAGE 


7 = 


2,000 WORDS 




LNGARY 


(1) 


= 10000 




LNGARY 


(2) 


= 2000 




LNGARY 


(3) 


200 




LNGARY 


(4) 


= 1500 




LNGARY 


(5) 


= 1500 




LNGARY 


(6) 


= 3000 




LNGARY 


(7) 


= 2000 


c 
c 


CALL LAYOUT 


FOR 7 PAGES 



c 

CALL LAYOUT (7, LNGARY) 

C 
C 
C 
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9.3 DEFINE USER COORDINATE SYSTEM 



NAME: SCALE 

FUNCTION: Allows the caller to define the X, Y coordinates (in floating point) 
of the lower left and upper right coordinates of the screen. FSP 
maps these user coordinates to display coordinates as the various 
FSP routines are called. 

CALLING FORMAT: CALL SCALE (XL, YL. XU, YU) 

DESCRIPTION OF PARAMETERS: 

(XLs YL) = Floating point variables containing the X and Y values to be 
assigned to the lower left corner of the displayable area. 

(XU, YU) = Floating point variables containing the X and Y values to be 
assigned to the upper right corner of the displayable area. 

DETAILED DESCRIPTION: 

All calls to FSP subroutines in which X, Y coordinates are supplied 
convert the floating point user coordinate into an integer display 
coordinate. It is the display coordinate which is then placed in the 
currently opened page. 

Without a call to SCALE, the user coordinate system is equal to the 
default display coordinate system, i.e., 

XL, YL = 0. ,0. 

XU, YU = +1023. ,+1023. 
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9.4 TURN BORDER DISPLAY ON 



NAME : ENBBOX 



FUNCTION: Allows the caller to display a rectangular border around the 
displayable area on the selected indicators. 

CALLING FORMAT: CALL ENBBOX (IND) 

DESCRIPTION OF PARAMETERS: 



IND - An integer variable indicating which of the four possible indicators 
the border is to be presented on. 



0 


- none 


• 8 - 


#1 




1 


- #4 


9 - 


#1 & 4 




2 


- #3 


10 - 


#1 & 3 




3 


- #3 & 4 


11 - 


#1. 3, 


& 4 


4 


- #2 


12 - 


#1 & 2 




5 


- #2 & 4 


13 - 


#1, 2, 


& 4 


6 


- #2 & 3 


14 - 


#1, 2, 


& 3 


7 


- #2, 3 & 4 


15 - 


#1, 2, 


3, 



& 4 (default) 



DETAILED DESCRIPTION 



This routine allows the caller to selectively display the border on any 
or all indicators. The default condition for FSP is to have the borders 
displayed on all indicators. 



9.5 TURN BORDER DISPLAY OFF 
NAME : DSABOX 

FUNCTION: Allows the caller to remove the rectangular border from selected 
indicators 

CALLING FORMAT: CALL DSABOX (IND) 

DESCRIPTION OF PARAMETERS: 



IND = An integer variable indicating which of the four possible border 
indicators to remove. See ENBBOX for the associated indicators 
values. 

DETAILED DESCRIPTION: 



Removes outline around the displayable area on selected indicators. 
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9.6 TURN ERROR DISPLAY ON 



NAME: ENBERR 

FUNCTION: Allows the caller to turn on the error display area • 

CALLING FORMAT: • CALL ENBERR (IND) 

DESCRIPTION OF PARAMETERS: 

IND - An integer variable indicating which of the four possible error 
displays to present. See ENBBOX for the associated indicators 
values . 

DETAILED DESCRIPTION: 

The error display is two digits in the upper left hand corner of the 
display. The initial value displayed is "00", If an error condition 
is detected, the error number is both displayed and an error event is 
created. The error numbers are listed in Appendix C. 



9.7 TURN ERROR DISPLAY OFF 
NAME: DSAERR 

FUNCTION: Allows the caller to remove the error display area from the 
selected indicator. 

CALLING FORMAT: CALL DSAERR (IND) 

DESCRIPTION OF PARAMETERS: 

IND = An integer variable indicating which of the four possible error 
displays to remove. See ENBBOX for a list of the values for 
IND and the associated indicators. 

DETAILED DESCRIPTION: 

Removes the error display from the requested indicators. Error events 
are still generated regardless of the status of the error display. 
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TERMINATE FSP MODE 
NAME: THEEND 

FUNCTION: Causes the GRAPHIC 7 terminal to return to the teletypewriter 
emulation mode of GCP+. All screens are cleared before FSP 
is terminated. 

CALLING FORMAT: CALL THEEND 

DETAILED DESCRIPTION: 

When the host application program is through with its FSP processing 
requirements, it must issue the THEEND call to notify the GRAPHIC 7 
terminal that it is no longer communicating with FSP and to place it 
in teletypewriter emulation mode. In the emulator mode, the display 
operator could then cause another graphics job to be run which would 
issue a GSS4 call to put the terminal back into the FSP mode of 
operation. 



V 

1 



SECTION 10 



IMAGE GENERATION ROUTINES 



The subroutines described in this section permit the application programmer to 
describe objects in user coordinates. The actual appearance of the objects on the 
GRAPHIC 7 display is determined by the following: 

• The graphic orders created by the calls to the image generation 
routines described in this section. 

MOVE Move beam to the position specified 

DRAW ~ Draw a line 

TEXT — ■ Display text characters 

POINT — Display a point 

CIRCLE — Draw a circle 



REFDAT — Transfer a block of predefined graphic orders. 

• The current value of display parameters which have been previously set 
by calls to the status subroutines: 

CPARM — Character size, spacing, and orientation. 

DPARM — Drawing and refresh rates 

STATUS — Blinking, intensity, line type, and display CRT usage 

COLOR — Color selection when applicable (red, yellow, green and 
orange) 

• The current pages and areas of pages being displayed which have been 
defined by previous calls to page management routines. 

PICTUR — Select pages to be displayed 

ERASER — Select area within page which is to be erased. 

Examples in Appendix E illustrate various display images generated by calls to 
routines in this section and the effects that display parameter settings and page 
management activities have on these images. 
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10.1 MOVE BEAM TO THE POSITION SPECIFIED 



NAME : MOVE 

FUNCTION: Generates either an absolute or relative move graphic order and 
places it at the mark position of the currently opened page* 

CALLING FORMAT: CALL MOVE (X, Y, MODE) 

DESCRIPTION OF PARAMETERS: 

Absolute mode (MODE =0, 2, or 3) 

! Absolute X, Y coordinate of the desired beam position. 
The coordinate is in the user coordinate system. 
Relative mode (MODE = 1) 
Relative X, Y coordinate (deltas) to be moved from the 
current beam position. These relative values are also 
in the user coordinate system. 

MODE = An integer variable supplied by the caller which identifies 
the type of graphic orders to be generated. 

0 ~ X, Y supplied is absolute and absolute graphic orders 

are to be generated 

1 = X, Y supplied is relative and relative graphic orders 

are to be generated 

2 = X, Y supplied is absolute but relative graphic orders 

are to be generated relative to the last absolute co- 
ordinate with MODE =3 

3 = X, Y supplied is absolute and absolute graphic order 

is to be generated (similar to MODE =0). It is expected, 
however, that subsequent calls to MOVE or DRAW will have 
MODE = 2. 

DETAILED DESCRIPTION: 

Mode = 2 and MODE 3 are provided to allow a user whose data base 
contains only absolute X, Y coordinates to produce relative graphic 
orders without calculating the deltas. 
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Example: C The following call produces an absolute graphic order 
C which moves the beam to (1,1) 

CALL MOVE (l.,l.,3) 
C The following call produces a relative graphic order 
C which draws the beam from absolute (1,1) to absolute 
C (3,3). The deltas computed are (2,2). 

CALL DRAW (3. ,3. ,2) 
C The following call produces another relative graphic 
C order 

C which draws the beam from absolute (3,3) to absolute (6,7). 
C The deltas computed are (3,4). 

CALL DRAW (6., 7., 2) 



The end result of the above example is that absolute coordinates were 
used to create a relative entity (entity consisting of an absolute 
move and two relative vectors) • The TBALL routine described in 
paragraph 17.1 can be used to link to the absolute move and to locally 
move the entity around under control of the PED. 



Example 



a) 


CALL 


MOVE 


(5. 


,6.,0) 


!ABS 


b) 


CALL 


MOVE 


(-3 


.,-3.,l) 


!REL 


c) 


CALL 


MOVE 


(2. 


.2. ,3) 


!ABS 


d) 


CALL 


MOVE 


(3. 


.3. ,2) 


!REL 


e) 


CALL 


MOVE 


(3. 


,2. ,2) 


!REL 



current position 



Y 



0,6 












^(a) 


0,5 














0,4 














0,3 






<^ 








0,2 






i 








0,1 





























0,0 1,0 2,0 3,0 4,0 5,0 

• Beam Position After Move 

Absolute Move 

Relative Move 
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10.2 DRAW A LINE 



NAME: DRAW 

FUNCTION: Generates either an absolute or relative draw graphic order 
and places it at the mark position of the currently opened 
page. 

CALLING FORMAT: CALL DRAW (X, Y, MODE) 

DESCRIPTION OF PARAMETERS: 

Absolute mode (MODE = 0, 2) 

Absolute X, Y coordinate of the end point of a line 
to be drawn. The coordinate is in the user co- 
ordinate system. 

Relative mode (MODE = 1) 

Relative X, Y coordinate to be used in drawing a line 
from the current beam position to a new position. 
These relative values are also in the user coordinate 
system. 

MODE = An integer variable supplied by the caller which identifies 
the type of graphic orders to be generated 

0 = X, Y supplied is absolute and an absolute draw 

graphic order is to be generated 

1 = X, Y supplied is relative and a relative draw 

graphic order is to be generated 

2 = X, Y supplied is absolute but a relative draw 

graphic order is to be generated 

DETAILED DESCRIPTION: 

The behavior of this routine is almost identical to the MOVE subroutine 
except that DRAW graphic orders are produced rather than MOVE 
graphic orders. Note, however, that MODE = 3 is not allowed for the 
DRAW routine. 

The attributes of the line drawn as a result of this call are deter- 
mined by previous user calls to the STATUS routine which sets up 
(1) the type of line (solid, dotted, dashed, dot-dashed), (2) blink 
or no blink, (3) intensity level and (4) the drawing rate. For color 
displays, a previous call to COLOR determines the color of the line. 
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Example 
C 

C DRAW A TRIANGLE USING ABSOLUTE COORDINATES 
C 



C 

C DRAW THE SAME TRIANGLE USING RELATIVE COORDINATES 
C 



CALL MOVE ,0) (a) 

CALL DRAW (2. ,3. ,1) (b) 
CALL DRAW (2. ,-3. ,1) (c) 
CALL DRAW (-4. 0,0. , 1) (d) 



CALL 
CALL 
CALL 
CALL 



MOVE (l.,l.,0) 

DRAW (3.,4.,0) 

DRAW (5. ,1. ,0) 

DRAW (l.,l.,0) 



(a) 
(b) 
(c) 
(d) 




10.3 DISPLAY TEXT CHARACTERS 



NAME: TEXT 

FUNCTIONS: Generates text graphic orders and places them starting at the 
mark position of the currently opened page, 

CALLING FORMAT: CALL TEXT (N, lARRAY) 

DESCRIPTION OF PARAMETERS:- 

N ~ An integer variable supplied by the caller indicating the 

number of text characters to be displayed. 

1 _< N £ 86 

lARRAY = An integer array supplied by the caller in which each element 
of the array contains an 8 bit ASCII character code right 
adjusted in the element (see Appendix B for character codes). 

DETAILED DESCRIPTION: 

If N is odd, a^hull character is stored as the last text character. 
When the currently opened page is displayed, the GRAPHIC 7 displays 
text starting at the current position of the beam in either a horizontal 
or vertical direction with c:haracter size and spacing determined by a 
previous user call to CPARM^; The text intensity, blink or no blink, 
and color (color displays only) has also been determined by calls to 
other FSP routines. The current beam position after the text is 
displayed is located at the location of the last text character drawn 
(blanks included) 



C 
C 
C 



NON-ROTATED TEXT 



CALL MOVE (1. ,1. ,0) 
CALL TEXT (12, lARRAY) 



THIS IS TEXT 



before after 
Beam Position 



C 
C 
C 



ROTATED TEXT 



CALL MOVE (1. ,1. ,0) 
CALL TEXT (12,IARRAY) 




After 



t 



Before 



Beam Position 
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10.4 DISPLAY A POINT 



NAME: POINT 

FUNCTION: Generates a "point" graphic order and places it at the mark 
position of the currently opened page. 

CALLING FORMAT: CALL POINT 

DETAILED DESCRIPTION: 

This call does not change the position of the beam but simply causes 
a point to appear at the current position of the beam. 

Example: C Plot 3 horizontal points starting 
C at (512,512) along the positive X 
C axis with the spacing between points = 5 

CALL MOVE (512. ,512. ,0) 

CALL POINT 

CALL MOVE (5. ,0. ,1) 

CALL POINT 

CALL MOVE (5.,0.,1) 

CALL POINT 
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10.5 DRAW A CIRCLE 



NAME: CIRCLE 

FUNCTION: Allows the caller to display specified quadrants of a circle 
centered around the current position of the beam. 

CALLING FORMAT: CALL CIRCLE (RADIUS, IQUAD) 

DESCRIPTION OF PARAMETERS: 

RADIUS ~ Radius of the circle in user coordinates « 

IQUAD = Which quadrants of the circle are to be displayed « 
where: 



0 




turn 


on 


all quadrants « 




1 




turn 


on 


quadrant 4 only 




2 




turn 


on 


quadrant 3 only 




3 




turn 


on 


quadrants 3 and 


4 only 


4 




turn 


on 


quadrant 2 only 




5 




turn 


on 


quadrants 2 and 


4 only 


6 




turn 


on 


quadrants'^ 2 and 


3 only 


7 




turn 


on 


quadrants 2, 3, 


and 4 only 


8 




turn 


on 


quadrant 1 only 




9 




turn 


on 


quadrants 1 and 


4 only 


10 




turn 


on 


quadrants 1 and 


3 only 


11 




turn 


on 


quadrants 1, 3, 


and 4 only 


12 




turn 


on 


quadrants 1 and 


2 only 


13 




turn 


on 


quadrants 1, 2, 


and 4 only 


14 




turn 


on 


quadrants 1 , 2 , 


and 3 only 
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DETAILED DESCRIPTION: 



This routine places a "draw circle" or "draw quadrant (s)" graphic order 
at the mark position of the currently opened page. When the currently 
opened page is displayed, the GRAPHIC 7 displays a circle or a series of 
quadrants (see description of IQUAD) at a distance equal to RADIUS around 
the current position of the beam. The current position of the beam re- 
mains unchanged. 



10.6 TRANSFER A BLOCK OF PREDEFINED GRAPHIC ORDERS 
NAME: REFDAT 

FUNCTION: Allows the caller to transfer and display a block of predefined 
graphic orders (MOVE, DRAW, TEXT, POINT, CIRCLE) 

CALLING FORMAT: CALL REFDAT (lARRAY, N) 

DESCRIPTION OF PARAMETERS: 

lARRAY = An integer array containing graphic orders right 

adjusted in the right-most 16 bits of each element. 

N == An integer variable containing the number of elements in 

the array. 

1 £ N £ 20 

DETAILED DESCRIPTION 

This routine takes the lower 16 bits (right-most) of the first N elements 
found in the array lARRAY and places them at the mark position of the 
currently opened page. 

The contents of the array lARRAY must be predefined graphic orders. 
The image generated by the transferred contents of the array lARRAY 
are displayed when the currently opened page is displayed. 
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SECTION 11 



PAGE MANAGEMENT ROUTINES 



The page management routines are used to select the memory address in the 
GRAPHIC 7 that will be used to store the next graphic instruction. The GRAPHIC 7 
memory address is calculated internally in FSP based on the current page selected 
and the current mark position. Each time the application program calls one of the 
image generation routines (MOVE, DRAW, TEXT, POINT, CIRCLE, REFDAT) , FSP generates 
the equivalent graphic controller instructions which are sent to the GRAPHIC 7 and 
stored in the GRAPHIC 7 memory. 

The page management routines consist of the following subroutines: 



ADDREF • 


- Open page for adding refresh data. 


UPDATE • 


- Open page for editing refresh data. 


ERASEP - 


- Erase from page mark to end of page. 


PICTUR - 


- Graphic subroutine call. 


REQMRK - 


- Request the present page mark. 


GETMRK - 


" Get mark request information. 


MOVEIM - 


- Move a block of graphic orders 


COPYIM - 


- Copy a block of graphic orders 



Refresh data refers to the block (or group) of graphic controller instructions 
that are used to display the desired image on the CRT indicator. 

When the application program calls the LAYOUT subroutine, the GRAPHIC 7 
memory is sectioned into pages. For example, if 3 pages were selected and page 1 
length was 2000, page 2 length was 1000, and page 3 length was 500, then the 
GRAPHIC 7 memory would look as follows: 
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ADDRESS 
0 



3000 



5000 



6000 



6500 



GRAPHIC 7 MEMORY 



Memory space used 
by GCP+ 



Start of Page 1 



Start of Page 2 



Start of Page 3 



End of memory for 
use by FSP 



These addresses were selected for illustrative purposes and may not be the 
same memory addresses that would be used by an FSP program. Note that in this 
example all addresses above 6500 are unassigned and would be unavailable for storage 
of refresh data. 

When refresh data is to be added to GRAPHIC 7 memory, the address is selected 
by adding the start address of the current page to the current mark. The following 
table indicates the GRAPHIC 7 memory address that would be selected, based on the 
current page and current mark. 

CURRENT CURRENT START ADDRESS GRAPHIC 7 MEMORY 

PAGE MARK OF PAGE ADDRESS 



1 0 3000 3000 

1 5 3000 3005 

2 0 5000 5000 

2 876 5000 5876 

3 0 6000 6000 
3 499 6000 6499 
3 500 6000 * 



*A mark selection of 500 would result in an error code being generated because the 
length of page 3 was only 500 and valid marks would be in the range of 0 to 499. 
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To illustrate the principles involved when using the page management routines, 
a simple FSP program will be reviewed in the areas related to page management. The 
program is given below; the image that would be displayed on a CRT for this program 
is shown in figure 11-1. 

NOTE 

Please read the subroutine descriptions for ADDREF, 
UPDATE, ERASEP, PICTUR, REQMRK and GETMRK before 
continuing. 

An FSP program which generates the display image in figure 11-1 is given 

below: 



T.TNF NO 






1 0 

J. w 


Oct J-X 






Pfll 1 

KjCLJ-JL. 


T AYOTTT /''^ TPAm^'c;^ 

jUrllVJUJ. \ -J , J-iJrrlVjrJIiD / 




LfdJL JL 


CIPAT F ^0 0 0 0 19 0 




KjdJLA. 


riL/JL/IVlLr V, J- / 




KjcLJu-L 


MOVF Tfi 0 0 O'i 


\J\J 


VjdJLJL 


DTJAw (in S S 0^ 

JL/I\xiW ^/.VJ, ^.^5 V/ 


70 




D"RAy 0 S S 0^ 

JL/X\XlVV Vi^O.VJ, \J J 


ou 




TFYT TT^^'YT^ 
1 Ji A 1 V. O 5 LL SLA. L J 






iii/jjivjir \ ^/ 


1 on 


1 1 


MOVF f'- S - S 1 ^ 

r iVJ VHi .J, JL^ 




vjcx JL JL 


DRAW MO 0 1^ 




VjCLXJL 


rjt? AW C 0 10 1 

Lf JXrxVV ^Vm/., x.v/, X/ 


1 '^0 


CX _L X 


"01? AW ('-I 0 0 I'i 


140 


Call 


DRAW CO -10 

JL/ivcxw x.v/, xy 


150 


Call 


ADDREF (3) 


160 


Call 


MOVE (-.5, 0., 1) 


170 


Call 


DRAW (1.0, 0., 1) 


180 


Call 


MOVE (-.5, -.5, 1) 


190 


Call 


DRAW (0, 1.0, 1) 


200 


Call 


ADDREF (1) 


210 


Call 


MOVE (1.5, 10.5, 0) 


220 


Call 


PICTUR (2) 


230 


Call 


MOVE (10.5, 10.5,0) 


240 


Call 


PICTUR (2) 


250 


Call 


MOVE (10.5, 1.5, 0) 


260 


Call 


PICTUR (2) 


270 


Call 


MOVE (1.5, 1.5, 0) 


280 


Call 


PICTUR (2) 


290 


Call 


MOVE (6.0, 8.0, 0) 


300 


Call 


PICTUR (3) 


310 


Call 


MOVE (6.0, 4.0, 0) 


320 


Call 


PICTUR (3) 



The call to GSS4 (line 10) initializes the FSP program and a full screen box 
and an error code value of "GO" are displayed on the CRT indicator. 
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X-AXIS 



0" 1" 2" 3" 4" 5" 6" 7" 




FIGURE 11-1 
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The call to LAYOUT (line 20) sections GRAPHIC 7 memory into three pages. 
The first word of each page (i.e., mark 0) is set up to contain an end of page 
mark. The end of page mark is equivalent to a return statement in a subroutine. 

The call to SCALE (line 30) sets up FSP to map all values in the range of "0" 
to "12" into the equivalent CRT coordinate system. The user coordinate system 
defines the lower left corner of the CRT as 0" , 0" and the upper right hand corner 
as 12", 12". For the CRT coordinate system the lower left corner is always -512,-512 
and the upper right corner is always +511, +511 This is always true regardless of 
which values are specified in the call to SCALE. 

The call to ADDREF (line 40) opens up page 1 in the add mode. In the add mode, 
an end of page mark (EPM) is added after each refresh data word is stored in page 1. 
This call also sets up a GRAPHIC 7 memory address pointer to point to the first word 
(mark 0) in page 1. After the call to ADDREF, page 1 looks as follows: 



Page 1 




Mark pointing here 



Undefined 



After the call to MOVE (line 50), page 1 looks as follows: 



Page 1 



MOVE 



EPM 



—Mark pointing here 



Undefined 



Note that after the call to MOVE, the mark value points to the new address 
in which the EPM is stored. 



After the two calls to DRAW (lines 60 and 70) and the call to TEXT (line 80), 
page 1 looks as follows: 



Page 1 



MOVE 



DRAW 



DRAW 



TEXT ('TEST ONE') 
EPM 4 — -Mark 



At this point the following is displayed on the CRT indicator. 



TEST ONE 



The call to ADDREF (2) (line 90) opens up page 2 in the add mode. This call 
also sets up a GRAPHIC 7 memory address pointer to point to the first word (mark 0) 
in page 2. It also saves the last mark value associated with page 1. 

After the call to MOVE (line 100) and the 4 calls to DRAW (lines 110 to 140), 
page 2 looks as follows: 



Page 2 



MOVE 



DRAW 



DRAW 



DRAW 



DRAW 



EPM 



-Mark 



At this point nothing in page 2 is displayed on the CRT indicator since a 
call to PICTUR has not been made. Page 1 is always displayed. 
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The call to ADDREF (3) (line 150) opens up page 3 in the add mode. This call 
also sets up a GRAPHIC 7 memory address pointer to point to the first word (mark 0) 
in page 3. It also saves the last mark value associated with page 2. 

After the calls to MOVE, DRAW, MOVE, DRAW (lines 160 to 190), page 3 looks as 
follows: 



Page 3 



MOVE 



DRAW 



MOVE 



DRAW 



EPM 



. Mark 



At this point nothing in page 3 is displayed on the CRT indicator since a call 
to PICTUR has not been made. 

The call to ADDREF (1) at line 200 re-opens page 1 in the add mode. This call 
also sets up a GRAPHIC 7 memory address pointer to point to the last word in page 1 
that contains the EPM. It also saves the last mark value associated with page 3. 



After the calls to MOVE and PICTUR (2) at lines 210 and 220, page 1 looks as 
follows: 



Page 1 



MOVE 



DRAW 



DRAW 



TEXT 



MOVE 



PICTUR (2) 



EPM 



-Mark 
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At this point a box is displayed at the top left side of the CRT indicator. 
The call to PICTUR (2) causes a subroutine call to be made to page 2. This causes 
the instructions in page 2 to be executed. When the EPM is executed in page 2, 
program control is returned back to page 1 (i.e., the EPM in page 1). 

After the remaining statements in the FSP program (i.e., lines 230 to 320) 
are executed, the GRAPHIC 7 memory looks as follows: 



Page 1 



MOVE 



DRAW 



DRAW 



TEXT 



MOVE 



PICTUR (2) 



MOVE 



PICTUR (2) 



MOVE 



PICTUR (2) 



MOVE 



PICTUR (2) 



MOVE 



PICTUR(3) 



MOVE 



PICTUR (3) 



EPM 



These instructions are 
executed first 



•All instructions in page 2 
executed 

'This instruction executed 
after page 2 

All instructions in page 2 
are executed again. 



■All instructions in page 3 
executed 



"Mark 



Undefined 
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Page 2 



MOVE 



DRAW 



DRAW 



DRAW 



DRAW 



EPM 



Undefined 



Page 3 



MOVE 



DRAW 



MOVE 



DRAW 



EPM 



Undefined 



At this point the image shown in figure 11-1 is displayed on the CRT indicator. 

NOTE 

The page 1 instructions are the only instructions 
that are directly executed. All instructions in 
pages 2 and 3 are executed indirectly via the PICTUR 
subroutine linkage. 

The UPDATE and ERASEP subroutines are normally used in response to some 
operator action. For example, the function keys on a keyboard could be programmed 
to cause certain modifications to a display image. To illustrate the use of UPDATE 
and ERASEP, let's say that it is now desired to perform the following actions in 
response to function key responses from an operator. 

FUNCTION KEY ACTION 

16 Remove box display from 4 corners. 

(Effectively delete or erase the 
instructions stored in page 2.) 

17 Replace the 'TEST ONE' characters with 

'TEST TWO' . 
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All operator inputs from the GRAPHIC 7 are returned via the EVENT subroutine. 
This subroutine is described in Section 13. To avoid confusion, let's say that the 
FSP program has been properly set up to detect function key responses. 

When a function key 16 response is detected, the following FSP code could be 
used to erase page 2: 

CALL UPDATE (2,0) 
CALL ERASEP 

The call to UPDATE sets up the GRAPHIC 7 address pointer to point to the first 
instruction in page 2. The call to ERASEP stores an EPM in page 2 which replaces 
the first instruction. 

Based on the previous example, page 2 would look as follows: 



Page 2 



EPM 



DRAW 



DRAW 



DRAW 



DRAW 



EPM 



• Mark 



These instructions won't 
be executed 



Undefined 



At this point the boxes are no longer displayed at the four corners. In 
page 1 there are four CALL PICTUR (2) instructions; but every time page 2 is executed 
now, the first instruction executed in page 2 is an EPM so program control returns 
to page 1. (I.e., the four DRAWS and second EPM in page 2 will never get executed.) 

NOTE 

When an ERASEP is executed, the page is also re- 
opened. This has the same effect as executing another 
ADDREF(2). For example, if the FSP program were 
coded in the following way in response to a function 
key 16 response: 

CALL UPDATE (2,0) 
CALL ERASEP 
CALL TEXT ( ) , 

then page 2 would look as follows after the TEXT 
instruction is executed: 
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Page 2 



TEXT 



EPM 



-Mark 



DRAW 



DRAW 



DRAW 



EPM 



Never executed 



Undefined 



At this point the text contained in the TEXT array would be displayed. 

In the previous example, if we want to replace the text 'TEST ONE' with 
'TEST TWO', we must know where the TEXT instruction is located in page !• The 
following code would have to be added to the previous example to determine the loca- 
tion of the TEXT instruction in page 1. 

LINE NO. 

71 CALL REQMRK 

72 10 CALL EVENT (lEVNT) 

73 IF (IEVNT.NE.7) GOTO 10 

74 CALL GETMRK (MARK) 

The above code would be inserted between lines 70 and 80. The call to REQMRK 
tells FSP to determine what the current mark value is. (Effectively, the mark 
points to the EPM which is where the TEXT instruction is stored.) When FSP deter- 
mines the current mark value, it sets up the EVENT table to contain a mark event 
(i.e., event type 7). The event type 7 response indicates that the current mark 
value is now stored in the EVENT table. The CALL to GETMRK retrieves the current 
mark value from the event table. After the call to GETMRK, the variable MARK 
contains the current mark value. MARK is saved for future updating. 

Now we are ready to process function key 17 type responses. For a function 
key 17 response, the following code would be added: 

CALL UPDATE (1, MARK) 

CALL TEXT ( ) 

CALL ADDREF (1) 
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The call to UPDATE sets up the address pointer to point to the address where 
the TEXT instruction ('TEST ONE') is located. The call to TEXT ('TEST TWO') 
replaces the previous TEXT instruction. At this point the CRT indicator would dis- 
play 'TEST TWO'. When UPDATE is executed, edit mode is entered. In this mode, no 
EPM is inserted after the TEXT instruction is added. After the TEXT instruction is 
executed, page 1 looks as follows: 



Page 1 



MOVE 



DRAW 



DRAW 



TEXT ('TEST TWO') 



MOVE 



PICTUR (2) 



MOVE 



PICTUR (2) 



MOVE 



PICTUR (2) 



MOVE 



PICTUR (2) 



MOVE 



PICTUR (3) 



MOVE 



PICTUR (3) 



EPM 



'TEST TWO' replaced 
■"'TEST ONE' 

^Mark (after TEXT instruc- 
"tion) 



-Mark (after ADDREF(l) 
instruction) 



Undefined 
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Note that after the TEXT instruction is replaced in GRAPHIC 7 memory, the 
mark is pointing to the MOVE following the TEXT instruction. The call to ADDREF(l) 
takes us out of edit mode and into add mode. After the call to ADDREF(l), the mark 
is repositioned to the EPM. The call to ADDREF(l) is necessary so that all future 
FSP subroutine calls made for page 1 will get added to the end of page 1. If no 
call to ADDREF(l) is made, all future FSP subroutine calls made for page 1 would be 
added following the TEXT instructions. In essence we would be destroying the refresh 
data in page 1 . 

When UPDATE is used, care must be used to ensure that refresh data is not 
destroyed. For example, when the 'TEST ONE' text was replaced, it was replaced with 
a TEXT string consisting of exactly 8 characters (i.e., the same number of characters 
as the original text string 'TEST ONE'). If a text string of more than 8 characters 
were inserted in place of the 'TEST ONE' text string, then these additional char- 
acters would be stored following the TEXT instruction. In this case the MOVE instruc- 
tion would be destroyed. If the TEXT string were vetj large, the remaining instruc- 
tions in page 1 could easily be over-written and destroyed. If the text string were 
less than 8 characters, then the text string would have to be space filled to a 
length of 8 characters. 

The MOVEIM and COPYIM subroutines are intended for use by advanced FSP users. 
It is strongly recommended that new FSP users get some experience writing FSP pro- 
grams before attempting to use the MOVEIM and COPYIM subroutines. 

NOTE 

Please read the subroutine descriptions for MOVEIM 
and COPYIM before continuing. 
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Normally a call MOVEIM is issued after the CALL COPYIM to remove the section 
data that has been copied. 



STEP A 



Copy from MARKA to MARKB to end of page. 



CALL COPYIM (MARKA, MARKB) 



STEP B 



Remove copied refresh 



CALL MOVEIM (MARKB, MARKA) 



STEP C 



10 



Get new page mark 
CALL EVENT (lEVENT) 
IF (lEVENT EQ» 7) GO TO 20 



OTHER PROCESSING 



C 
C 
C 



20 



GO TO 10 
GET NEW PAGE MARK 

CALL GETMRK (MARKC) 



MARKA • 
MARKB- 




END OF 
PAGE 



END OF PAGE 



RESULTS OF STEP A 



RESULTS OF STEP B 
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11.1 OPEN PAGE FOR ADDING REFRESH DATA 



NAME: ADDREF 

FUNCTION: This routine opens the specified page and sets the mark to either 
the beginning of the page, if it is empty, or directly following 
the last data entered into the page. 

CALLING FORMAT: CALL ADDREF (IPAGE) 

DESCRIPTION OF PARAMETERS: 

IPAGE = An integer variable containing the page number to be opened. 

1 < IPAGE < 255 

DETAILED DESCRIPTION: 

This subroutine is used to set up a page for initial orders (if empty) 
or for addition of graphics orders to the page. This subroutine does not 
give the caller the ability to edit • previous graphic orders as does the 
UPDATE subroutine (see next description). 



11.2 OPEN PAGE FOR EDITING REFRESH DATA 
NAME: UPDATE 

FUNCTION: The requested page is opened for editing with the page mark set to 
the value supplied by the caller. 

CALLING FORMAT: CALL UPDATE (IPAGE, MARK) 

DESCRIPTION OF PARAMETERS: 

IPAGE = An integer variable containing the page number to be opened. 

1 < IPAGE < 255 

MARK = An integer variable containing the position in the page where the 
mark is to be positioned. 

DETAILED DESCRIPTION: 

The current page and mark are set to IPAGE and MARK, and mode is changed 
to edit. Used to modify existing refresh. Note that in the edit mode it is 
possible to inadvertently insert refresh instructions, over and beyond the 
current page ending. This will most likely cause an error. 
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11.3 ERASE FROM PAGE MARK TO END OF PAGE 



NAME: ERASEP 

FUNCTION: This routine erases the currently open page from the current 
position of the mark to the end of the page. It does not 
change the mark. 

CALLING FORMAT: CALL ERASEP 

DETAILED DESCRIPTION: 

An "end of page" graphic order is placed at the present position of the 
"mark" causing all graphic orders following it to be removed from the graphic 
flow. If the program mode is in edit (UPDATE has been called) , the program 
is taken out of the edit mode and into addition mode (equivalent to calling 
ADDREF) . 

11.4 GRAPHIC SUBROUTINE CALL 
NAME: PICTUR 

FUNCTION: Causes the contents of the specified page to be displayed at the 
current mark and beam position, i. e. , a graphic subroutine order 
is inserted at the present page mark. 

CALLING FORMAT: CALL PICTUR (IPAGE) 

DESCRIPTION OF PARAMETERS :. 

IPAGE = An integer variable containing the page number to be 
displayed (that is, linked to). 

-1 reserves space for a subsequent page call in the update mode. 

DETAILED DESCRIPTION: 

This routine causes the contents of page IPAGE to be called from the 
current mark and beam position. Note that the page calls should not be arranged 
so that a page can eventually call itself. See Section 6 for a more detailed 
description. 

If IPAGE = -1, then three no operation instructions (NOP's) are inserted 
into the current page. The mark is advanced by 3. 
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11.5 REQUEST THE PRESENT PAGE MRK 
NAME : REQMRK 

• FUNCTION: Allows caller to determine the location of the next available 
location on a page. 

CALLING FORMAT: CALL REQMRK 

DETAILED DESCRIPTION: 

This routine causes the host program to request the current mark. The 
user then calls EVENT and GETMRK to get the value. The user may then use the 
value of the mark for subsequent updates. 

11.6 GET MARK REQUEST INFORMATION 
NAME: GETMRK 

FUNCTION: Retrieves from the event tables the information requested by the 
REQMRK call. 

CALLING FORMAT: CALL GETMRK (M) 

DESCRIPTION OF PARAMETERS: 

M = An integer variable returned to the caller containing the present 
page mark. 

DETAILED DESCRIPTION: 

This routine retrieves the value of the mark after a mark event has been 
received. 
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11.7 MOVE A BLOCK OF GRAPHIC ORDERS 



NAME: MOVEIM 

FUNCTION: Allows the caller to move all data between a given position and the 
end of the current page to another mark position on that page. The 
current mark (end of page) will be changed. Current page mark can 
be obtained by calls to EVENT and GETMRK. 

CALLING FORMAT: CALL MOVEIM (MARKFR, MARXTO) 

DESCRIPTION; OF PARAMETERS: 

MARKER = Integer variable indicating the mark location that data 
will be moved from. 

MARKTO = Integer variable indicating the mark location that the 
data will be moved to. 

The following condition must exist: 

MARKTO < MARKER < END OF PAGE 

DETAILED DESCRIPTION: 

This routine moves data between a specified mark location (MARKFR) and 
the current end of page to a given mark location (MARKTO) . The current end 
of page will be changed to equal MARKTO plus the length of the data move (old 
end of page minus MARKFR) . 

This routine automatically sends the current mark (new end of page) back 
to the host as if a CALL REQMRK had been issued by the host. The user calls 
EVENT and GETMRK to get the value. The user may use the value of the mark 
for subsequent updates. 

The following error codes can be generated for MOVEIM: 

ERROR CODE MEANING 

65 MARKTO MARKFM 

66 MARKFR> END OF PAGE 
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In terms of GRAPHIC 7 memory, the current page is altered as shown below 
when a CALL MOVEIM (MARKFR, MRKTO) is executed. 




The result of the MOVEIM operation is that section B has been deleted 
from refresh memory and additional refresh memory has been freed for re-use 
by the FSP programmer* 
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11.8 COPY A BLOCK OF GRAPHIC ORDERS 



NAME: COPYIM 

FUNCTION: Allows the user to copy the data between two given marks on the 
current page to the end of that page. The current mark (end of 
page) changes. 

CALLING FORMAT: CALL COPYIM (MARKA, MARKS) 

DESCRIPTION OF PARAMETERS: 

MARKA - An integer variable specified by the caller which gives the 
starting mark location of the data being copied » 

MARKB ~ An integer variable specified by the caller which gives the 
last mark location of the data being copied. 

The following condition must exist: 

MARKA < MARKB < END OF PAGE 

Space must be available at the end of the page. 

DETAILED DESCRIPTION: 

This routine copies data between two given marks on the current page to 
the end of the current page. The current end of page is modified to equal 
the end of page prior to the CALL COPYIM plus the length of the data copied. 

This routine determines if room is available at the end of the page for 
the data to be copied. If not enough space is available, error 64 is issued 
and no data is copied. 

This routine allows the user to expand an existing image by copying or 
appending the image to the end of the current page where additional FSP func- 
tions may be performed. 

This routine automatically sends the current mark (new end of page) 
back to the host as if a CALL REQMRK had been issued by the host. The user 
calls EVENT and GETMRK to get the new mark value. 

The following error codes can be generated for COPYIM: 

ERROR CODE MEANING 

62 MARKA > MARKB 

63 MARKB > END OF PAGE 

64 Not enough room on page for copy. 
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In terms of GRAPHIC 7 memory, the current page is altered as shown 
below when a CALL COPYIM (MARKA, MARKB) is executed. 



Memory before 
CALL TO COPYIM 



Current page 



MARKA 



MARKB 



END OF 




PAGE MAP.K 



Memory after 
CALL TO COPYIM 



Current page 



MARKA 



MARKB 



OLD END 
OF PAGE 
MARK 

NEW END 




OF PAGE MARK 



The result of the COPYIM operation is that a copy of the refresh code 
in Section B is appended to the end of the current page. After the COPYIM 
operation, the mark pointer changes to reflect the new end of page mark. 
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SECTION 12 



STATUS ROUTINES 



The following routines described in this section allow the caller to define 
how the display data (graphic orders) will be seen, which PHOTOPENs are enabled, 
and which keyboard function keys are lit, 

CPARM — set character parameters for size, orientation, 
and spacing 

DPARM ■ — set drawing and refresh rate and enable 
PHOTOPEN 

STATUS — set blinking, intensity, line style, and 
indicator selection(s) 

LAMPON — Turn keyboard function key on 

LAMPOF — Turn keyboard function key off 

COLOR — Select red, orange, yellow, or green 
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12.1 SET CHARACTER PARAMETERS 



NAME : CPARM 

FUNCTION: Allows the caller to select the character parameters: size, 
spacing, and orientation. 

CALLING FORMAT: CALL CPARM (ICSIZE, ICROT, ICSPAC) 

DESCRIPTION OF PARAMETERS: 

ICSIZE = Integer variable selecting the character size desired. 
Normal height 12" x 12" display 

0 = size 0 (smallest) 0. 125(inches) 

1 = size 1 (1,5 times size 0) 0. 187 (inches) (default) 

2 = size 2 (2.0 times size 0) 0, 250(inches) 

3 = size 3 (3.0 times size 0) 0. 375(inches) 

ICROT - Integer variable indicating the character orientation. 

0 = normal (horizontal) (default) 

1 = rotate 90° CCW 

ICSPAC = Integer variable containing the spacing (in dits) between 
characters. 

Recommended Spacing Value 

Size 0 — 10 

Size 1 — 15 (default) 

Size 2 — 20 

Size 3 ~ 30 

DETAILED DESCRIPTION 

This routine generates a graphic order containing the caller specified 
character size, orientation, and spacing and places it at the mark position 
of the currently opened page. Since the GRAPHIC 7 uses a hardware character 
generator to display character, scaling has no impact on these character 
parameters. 
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12.2 SET DISPLAY PARAMETERS 



NAME: DPARM 

FUNCTION: Allows the caller to set the GRAPHIC 7 display parameters for 

drawing and refresh rate as well as enable and disable a selected 
PHOTOPEN, 

CALLING FORMAT: CALL DPARM (ISP, ISYNC, IPEN) 
DESCRIPTION OF PARAMETERS: 

ISP = Integer variable selecting the drawing rate desired 

0 = fast drawing rate (default) 

1 = slow drawing rate 

ISYNC = Integer variable selecting the refresh rate desired 

0 = no change 

1 = 60 Hz (normal) (default) 

2 = 40 Hz 

3 = 30 Hz 

IPEN = Integer variable selecting the PHOTOPEN to be enabled 

0 = Both PHOTOPENs disabled 

1 = PHOTOPEN 1 enabled 

2 = PHOTOPEN 2 enabled 

3 = Both PHOTOPENs enabled (default) 

DETAILED DESCRIPTION: 

This routine generates a graphic order containing the caller specified 
drawing and refresh rates and enabled PHOTOPEN (s) and places it at the mark 
position of the currently opened page. 
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SET DISPLAY STATUS 



NAME: STATUS 

FUNCTION: Allows the caller to control blinking, intensity, line style, and 
indicator selection. 



CALLING FORMAT: CALL STATUS (IBL, INT, IVT, IND) 



DESCRIPTION OF PARAMETERS: 



IBL " Integer variable controlling blinking 

0 = stop blinking (default) 

1 = start blinking 

INT = Integer variable selecting 0-7 intensity levels 

0 = invisible 

1 = very dim 

7 = (default) very bright 

INT = Integer variable selecting line style 

0 = solid vectors (default) 

1 = dotted vectors 

2 = dashed vectors 

3 = dot-dashed vectors 



IND = Integer variable selecting 



0 - 


none 


1 - 


#4 


2 - 


//3 


3 - 


#3 & 4 


4 - 


#2 


5 - 


#2 & 4 


6 - 


#2 & 3 


7 - 


#2, 3, & 4 



indicators are to be refreshed 



8 


- #1 


9 


- #1 & 4 


10 


- #1 & 3 


11 


- #1, 3, & 4 


12 


- #1 & 2 


13 


- #1, 2, & 4 


14 


- #1, 2, & 3 


15 


-in, 2, 3, & 4 (default) 


-1 


= indicator not changed. 




Indicator specified in 




previous call to STATUS 




remains in effect. 



DETAILED DESCRIPTION: 



This routine generates a graphic order containing the caller specified 
display attributes for blinking, intensity, line style and indicator selection 
and places it in the currently opened page at the location pointed to by the 
page's mark pointer. The display will remain in the specified status until 
changed by another call to STATUS. 



12.4 TURN KEYBOARD LAMP ON 



NAME: LAMPON 

FUNCTION: Allows the caller to turn on a selected lamp on the selected 
keyboard. 

CALLING FORMAT: CALL LAMPON (KBD, LAMP) 

DESCRIPTION OF PARAMETERS: 

KBD = Integer variable specifying which of the two possible 
keyboards 

1 = Keyboard 1 

2 = Keyboard 2 

LAMP = Integer variable specifying which of the lighted function keys 

is to be lighted. NOTE: If LAMP = -1 then all lamps are turned 
on. 

DETAILED DESCRIPTION: 

Lamps are numbered 0-31. The top row is numbered 16-31, left to right. 
The lamp number is the same as the key number. 



FUNCTION KEYS: 



16 


17 


18 


19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 


30 


31 



MTRIX KEYS: 



7 


8 


9 


15 


4 


5 


6 


14 


1 


2 


3 


13 


10 


0 


11 


12 



\ 
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12.5 TURN KEYBOARD LAMP OFF 



NAME: LAMPOF 

FUNCTION: Allows the caller to turn off a selected lamp on a selected 
keyboard. 

CALLING FORMAT: CALL LAMPOF (KBD, LAMP) 

DESCRIPTION OF PARAMETERS: 

KBD ~ Integer variable specifying which of the two possible 
keyboards 

1 = Keyboard 1 

2 = Keyboard 2 

LAMP = Integer variable specifying which of the lighted function keys 
is to be turned off. NOTE: If LAMP = -1, then all lamps are 
turned off. 

DETAILED DESCRIPTION: 

Lamps are numbered 0-31. The top row is numbered 16--31 left to right. 
The lamp number is the same as the key number. 

FUNCTION KEYS: 



16 


17 


18 


19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 


30 


31 



MATRIX KEYS: 



7 


8 


9 


15 


4 


5 


6 


14 


1 


2 


3 


13 


10 


0 


11 


12 
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12.6 SET DISPLAY COLOR 



NAME: COLOR 

FUNCTION: Allows the caller to select one of four colors for the specified 
indicator (s) . 

CALLING FORMAT: CALL COLOR (ICOLOR, IND) 

DESCRIPTION OF PARAMETERS: 

ICOLOR = Integer variable containing the number of the color desired. 

0 = red 

1 == orange 

2 = yellow 

3 = green (default) 

IND = Integer variable specifying the number of the desired 
indicator(s) 



0 


- none 


8 


- #1 




1 


- #4 


9 


- #1 & 4 




2 


- #3 


10 


- #1 & 3 




3 


- #3 & 4 


11 


- -#1, 3, 


& 4 


4 


- #2 


12 


- #1 & 2 




5 


- #2 & 4 


13 


- #1, 2. 


& 4 


6 


- #2 & 3 


14 


- #1, 2, 


& 3 


7 


- #2, 3, & 4 


15 


- #1, 2, 


3. & 



DETAILED DESCRIPTION: 

Routine creates a graphic order to change color and places it at the mark 
position of the currently open page. When possible, all codes of one color 
should be grouped together. A maximum of four color changes are allowed in 
an FSP program. If the color is changed more than four times, then the color 
change selection probably won't take place. The color CRT is protected against 
incorrect programming so the FSP programmer need not be overly concerned if an 
error is made and the FSP program contains 5 or 6 color changes. 
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SECTION 13 
EVENT ROUTINE 



An asynchronous (unpredictable) "event'* may occur when one of the following 
operat:or actions takes place: 

A PHOTOPEN select is performed on a blank screen while in the "scan" 
mode. 

A PHOTOPEN select is performed on a graphic item while in the "item" 
mode. 

One of the 16 function keys on the alphanumeric/function keyboard is 
pressed. 

One of the 16 matrix keys on the alphanumeric /function keyboard is 
pressed. 

An alphanumeric key depression causes the "text input" buffer to 
become full. 

A CR (carriage return) key is pressed on the alphanumeric/function 
keyboard. 

The data tablet pen is pressed and released while in the "automatic" 
mode. 

Another asynchronous event is the "error" event which is generated when any 
of the error conditions described in Appendix C are detected. These error conditions 
fall xnto the following categories: 

• System errors 

A. Overload conditions 

B. Malfunctions 

• Incorrect calling sequence 

• User parameter errors 

• Currently defined page refresh exceeded 

• Miscellaneous 

The final asynchronous event is the "illegal response from terminal" event. 
This event occurs when FSP in the host receives a message from the GRAPHIC 7 which 
is incomprehensible. 
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A synchronous (predictable) "event" will occur as a result of the following 
FSP calls: 



REQTB 

REQIM 

REQPXY 

HCOPY 

REQMRK 



Request current coordinate of 
Request refresh data 
Request single PHOTOPEN scan 
Request hardcopy 
Request mark. 



PED 



"event" has occurred only by calling 



The FSP programmer becomes aware that an 
the EVENT subroutine described in paragraph 13a. The EVENT subroutine returns an 
event code value to the caller which Indicates either that no event has occurred 
or that one of the above asynchronous or synchronous events has occurred. 



13.1 POLL TERMINAL FOR EVENT OR REQUEST RESPONSE 



NAME: EVENT 

FUNCTION: Issues a poll request to GCP+ and waits for a poll response. An 
event code is returned to the caller indicating the type of event 
(if any) c 



CALLING FORMAT: CALL EVENT (lEVNT) 



DESCRIPTION OF PARAMETERS: 

lEVNT = An integer variable returned to the caller indicating the 
event type. 



1 =s No events. 

2 = PED motion, call GETTB 

3 = A line of text is available, call GETTXT . 

4 = A function key was pressed, call GETKEY. 

5 = There was a PHOTOPEN detect, call GETPEN. 

6 = PHOTOPEN XY found, call GETPXY. 

7 = Mark response available, call GETMRK. 

8 = Error (XY overflow, halt, index out of range, etc.), 

call GETERR. 

9 = Refresh dump available, call GETIMo 

10 = Hardcopy complete. 

11 = Unused. 

12 = Illegal response from the terminal. 
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SECTION 14 



ALPHANUMERIC KEYBOAED ROUTINES 



This section describes the routines available to the user to handle alpha- 
numeiric and function keyboard data. These routines are named below: 

• ENBPAD - Enable alphanumeric scratchpad 

• DSAPAD - Disable alphanumeric scratchpad 

• GETTXT - Retrieve alphanumeric text information 

• GETKEY - Retrieve function key information 

FSP allows and supports up to two alphanumeric /function keyboards. These 
keyboards combine a 32 function keyboard and an alphanumeric keyboard into one 
physical unit. A single keyboard system has the keyboard connected to port 3 of the 
first multiport serial interface. An additional keyboard may be added, and is con- 
nected to port 7 of the second multiport serial interface. 

Multiport serial #1 



PORT 


1 


PORT 


2 


PORT 


3 


PORT 


4 



- Alphanumeric /function keyboard #1 



Multiport serial #2 



PORT 


5 


PORT 


6 


PORT 


7 


PORT 


8 



- Alphanumeric/function keyboard #2 
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Each keyboard has an 86 character buffer or pad associated with it which 
receives alphanumeric key characters as they are typed. The pad is refreshable and 
is displayed as a single line of text at a user specified X, Y coordinate. 

A "text" event is created (event code = 3) when one of the following operator 
actions take place: 

• An alphanumeric key depression causes the associated pad to become full « 

• A "return" key is pressed and at least one character is already in the 
pad . 

Once a "text" event is created, the pad is cleared (reset to blanks). 

A "key" event (event code = 4) is created when the operator presses any of the 
16 function keys or any of the 16 matrix keys. 



14.1 ENABLE ALPHANUMERIC SCRATCH PAD 
NAME: ENBPAD 

FUNCTION: Specifies parameters for pad for entry of information from 
alphanumeric keyboard. 

CALLING FORMAT: CALL ENBPAD (IKEY, IND, X, Y, IMAX) 

DESCRIPTION OF PARAMETERS: 

IKEY - (1 or 2) keyboard number specified by the caller. 

IND = (0 thru 15) indicators on which the caller wishes alphanumeric 
information displayed. See STATUS routine for which values 
correspond to which indicators. 

X = Real variable specified by the caller indicating the X position 

in user coordinates of first character. 

Y = Real variable specified by the caller indicating the Y position 

in user coordinates of first character. 

IMAX = (1 thru 86) user specified number of characters allowed in pad 
(default is 1) . 

DETAILED DESCRIPTION: 

This routine allows the user to establish for each keyboard the location 
of the display of a single line of text entered from the alphanumeric keys. 
See GETTXT for further information. Note that the keyboard is always enabled. 
ENBPAD only displays the pad and establishes its parameters. The user may use 
the keyboard without enabling the pad. If the user does not call ENBPAD, the 
default IMAX of 1 is used, which means that every alphanumeric key depression 
causes a text event (event code = 3) . 
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14.2 DISABLE ALPHANUMERIC SCRATCH PAD 



NAME : DSAPAD 

FUNCTION: Turns off the display of the alphanumeric keyboard information. 

CALLING FORMAT: CALL DSAPAD (IKEY) 

DESCRIPTION OF PARAMETERS: 

IKEY = The keyboard number (1 or 2) specified by the caller. 

DETAILED DESCRIPTION: 

Turns off the display only for the selected keyboard. Does not change 
any other parameters. The user may still use the keyboard and events are 
still generated as explained in GETTXT. DSAPAD simply causes the keyboard 
information not to appear on the displays. 

14.3 GET TEXT EVENT INFORMATION 

NAME : GETTXT 

FUNCTION: Transfers the text buffer characters obtained by the EVENT 
subroutine to the caller. 

CALLING FORMAT: CALL GETTXT (lARRAY, ISIZE, NCHAR, KBD) 

DESCRIPTION OF PARAMETERS : 

lARRAY = A user defined integer array into which the currently com- 
pleted text input buffer is transferred. Each array element 
contains one 8-bit ASCII character in the rightmost 8 bits of 
the element. 

An integer variable supplied by the caller containing the 
maximum number of characters to be placed in the array, i.e., 
ISIZE is the size of the array. If an input buffer string is 
longer than the array size, those characters which don't fit 
are lost. 

An integer variable returned to the caller, containing the 
number of characters (elements) placed in the array. The "NL" 
(new line) character used to terminate the input buffer is not 
included in the array or character count. 

An integer variable returned to the caller indicating the 
keyboard to which the input buffer is associated. 

KBD = 1 = keyboard #1 
KBD = 2 = keyboard #2 



ISIZE 



NCHAR 



KBD 
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DETAILED DESCRIPTION: 



This subroutine should normally be called only after a call to EVENT has 
indicated that a "text" event has occurred. 

Associated with each of the two alphanumeric keyboards in the terminal is 
an 86-character input buffer (there are two such buffers). As a key is 
pressed on the keyboard, its corresponding character is added to the next 
character position in its corresponding input buffer. If a typing error is 
made while entering characters into the scratchpad, the RUBOUT key can be used 
to make corrections. RUBOUT deletes the last character typed. Successively 
pressing RUBOUT can delete the entire line. 

The scratchpad characters are sent to the host and the input buffer is 
cleared (reset to blanks) when one of the following events occurs s 

1. A new line or the carriage return key is typed. 

2. A call to GSS4 is made. 

3. The buffer is full. 

See ENBPAD for further information. 

NOTE 

If the scratchpad is empty and a carriage 
return is entered, no event flag is sent 
back to the host. 

14.4 GET FUNCTION KEY EVENT INFORMATION 

NAME: GETKEY 

FUNCTION: Retrieves from the event tables the function key event information. 

CALLING FORMAT: CALL GETKEY (KBD, KEY) 

DESCRIPTION OF PARAMETERS: 

KBD = An integer variable returned to the caller indicating which of 
the two keyboards caused the event. 

KBD = 1 = keyboard #1 
KBD = 2 = keyboard #2 

KEY = An integer variable returned to the caller indicating which of 
the 32 function keys was pressed. 
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DETAILED DESCRIPTION: 

This routine retrieves the key number after a function key event has 
been received. Function keys are always enabled. 

FUNCTION KEYS: 



16 


17 


18 


19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 


30 


31 



MATRIX KEYS: 



7 


8 


9 


15 


4 


5 


6 


14 


1 


2 


3 


13 


10 


0 


11 


12 
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SECTION 15 



PHOTOPEN ITEM ROUTINES 

The PHOTOPEN can be used in two distinct ways: 

• As a positional entry device 

• As an item selection device 

The two modes differ. Use as a positional entry device requires no graphics 
information on the screen; use as an item selection device requires existing 
graphics. Section 16 describes the positional entry mode. This section describes 
the item selection mode. The following subroutines are presented in this section: 

ENBPEN - Enable global PHOTOPEN sensitization 

DSAPEN - Disable global PHOTOPEN sensitization 

ITEM - Define a graphic item 

GETPEN - Get PHOTOPEN event information 

A page or sections of a page (items) may either be PHOTOPEN responsive or 
non-PHOTOPEN responsive. A PHOTOPEN responsive item generates a PHOTOPEN event 
(event code 5) when the following operator actions are performed: 

(1) The operator places the PHOTOPEN over any character, vector, conic, 
or point making up the item. 

(2) The PHOTOPEN is pressed to activate its switch. 

A PHOTOPEN event then makes available to the FSP programmer (via subroutine 
calls) the following information: 

• PHOTOPEN number (1 or 2) 

• Page and mark of exact graphic order within the item 

• Type of graphic order (text, vector, code, point) 

• Calling page if item is a refresh subroutine 

• Text byte 

• Item number 

An item that is not PHOTOPEN responsive does not generate a PHOTOPEN event 
when the above operator actions are performed. 

Two levels of sensitization are required to make an item PHOTOPEN responsive. 
Without these two levels enabled an item is not PHOTOPEN responsive. 
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Local Sensitization 



This type of sensitization is provided by the DPARM subroutine and is used 
when the programmer wishes to sensitize an item locally. The same routine is used 
for desensitization, e.g. 

CALL DPARM 
CALL MOVE \ 
CALL DRAW / 

CALL DPARM 

CALL MOVE ) 

CALL DRAW / 

CALL DRAW ) 

CALL DPARM 
CALL POINT ) 



A page built as a result of the above calls, when refreshed , is not yet 
PHOTOPEN responsive; i.e., an attempt to PHOTOPEN either item 1 or item 3 does not 
create a PHOTOPEN event. Global sensitization is required to make this possible. 

Global Sensitization 

The enabling and disabling of global sensitization is provided by the ENBPEN 
and DSAPEN routines. Global enabling (ENBPEN) allows all locally sensitized items 
in all pages to be PHOTOPEN responsive; i.e., a locally sensitized block when 
globally sensitized creates a PHOTOPEN event when penned. 

Example: 





CALL 


DSAPEN 










^ CALL 


DPARM 










i CALL 


DRAW ] 


Item 


1 


- Locally sensitized 


Items 1,2,3 J 


' CALL 


DPARM 








Not PHOTOPEN j 


1 CALL 


DRAW ] 


Item 


2 


- Locally sensitized 


responsive | 


' CALL 


DPARM 










CALL 


DRAW ] 


Item 


3 


- Locally sensitized 




CALL 


ENBPEN 








Items 1,2,3 












PHOTOPEN 


I: 










responsive 













CALL DSAPEN 
Items 1,2,3 ( - 

Not PHOTOPEN I - 
responsive ( - 



Sensitized (item 1) 



Desensitized (item 2) 



Sensitized (item 3) 
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The FSP programmer detects PHOTOPEN events by calling the EVENT routine and 
checking the returned event code for a value of 5. If a PHOTOPEN event is detected, 
then the FSP programmer must call the GETPEN subroutine, which returns to the caller 
all the PHOTOPEN event information. 

Example: 

CALL EVENT (lEVNT) 

IF (lEVNT • EQ • 5) CALL GETPEN ( ) 



15.1 ENABLE GLOBAL PHQTOPEN SENSITIZATION 
NAME: ENBPEN 

FUNCTION: Allows any locally sensitized pages or items to be PHOTOPEN 
responsive to the selected PHOTOPEN. 

CALLING FORMTS: CALL ENBPEN (IPEN) 

DESCRIPTION OF PARAMETERS: 

1 1 = PHOTOPEN #1 activated 
IPEN = { 

(2 = PHOTOPEN #2 activated 

DETAILED DESCRIPTION : 

This call may be made before, during, or after the creation of a page 
or pages. 

15.2 DISABLE GLOBAL PHOTOPEN SENSITIZATION 
NAME: DSAPEN 

FUNCTION: Causes all locally sensitized pages or items to be globally de- 
sensitized to the selected PHOTOPEN. 

CALLING FORMAT: CALL DSAPEN (IPEN) 
DESCRIPTION OF PARAMETERS: 

II = PHOTOPEN #1 deactivated 
2 = PHOTOPEN #2 deactivated 
DETAILED DESCRIPTION: 

Performs opposite action of ENBPEN. 
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15.3 DEFINE A GRAPHIC ITEM 



NAME: ITEM 

FUNCTION: Allows the caller to associate an identifying number to all calls 
(MOVE, DRAW, etc.) which follow this call. 

CALLING FORMAT: CALL ITEM (NUM) 

DESCRIPTION OF PARAMETERS: 

NUM = Integer number associated with the calls that follow. 

DETAILED DESCRIPTION: 

The caller can use this routine to give identifying numbers to items in 
the refresh file. This item number is returned to the caller via calls to 
GETPEN routine. 

It is often desirable to group several vectors, points, characters, etc., 
into a logical entity or item and to make it PHOTOPEN responsive in such a 
way that penning any vector, point, character, etc. within the item causes a 
PHOTOPEN event, which in turn provides the item number. 

Example: 

CALL ITEM (25) 
CALL DPARM 

CALL DRAW <4 ITEM 25 

CALL ITEM (26) 

CALL DRAW ^ ITEM 26 
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15.4 GET PHOTOPEN EVENT INFORMATION 



NAME: GETPEN 

FUNCTION: Retrieves from the event tables all of the information concerning 
the PHOTOPEN event. 

CALLING FORMAT: CALL GETPEN (IPEN,IPAGE,MARK,ITYPE,ICPAGE,IBYTE5lTMNUM) 
DESCRIPTION OF PARAMETERS: 

IPEN = An integer variable returned to the caller identifying 
which pen caused the event. 

IPEN = 1 = PHOTOPEN #1 
IPEN = 2 = PHOTOPEN #2 

IPAGE = An integer variable returned to the caller identifying the page 
number in which the event occurred. 

MARK = An integer variable returned to the caller giving the "mark" 
of the graphic order which caused the events 

ITYPE = An integer variable returned to the caller identifying the 
type of graphic order which caused the event, 

1 = text 

2 = vector 

3 = circle 

4 = point 

5 = short vector 

ICPAGE = An integer variable returned to the caller identifying the 
page number of the calling page. 

IBYTE = An integer variable returned to the caller identifying the 
text byte causing the event. 

ITMNUM = An integer variable returned to the caller giving the value 
of the item number at the event position. 

DETAILED DESCRIPTION: 

This routine retrieves the PHOTOPEN event information from the event 
tables. The page or item must have been locally sensitized by DPARM and 
globally sensitized by ENBPEN to allow this event to occur. 
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SECTION 16 



PHOTOPEN SCAN ROUTINES 

Section 15 described the PHOTOPEN routines available when the PHOTOPEN is used 
to pen existing graphic items on the screen. This section describes how the 
PHOTOPEN can be used to point to a blank area of the screen and obtain the X, Y 
position of that point. The following routines are described in this section: 

ENBPXY - Enter multiple PHOTOPEN scan mode 

DSAPXY - Leave multiple PHOTOPEN scan 

REQPXY - Request single PHOTOPEN scan 

GETPXY - Get PHOTOPEU scan event data 

When PHOTOPEN scan is enabled (ENBPXY or REQPXY), PHOTOPEN events (event code 
5) are not possible (see Section 15) but rather PHOTOPEN scan events are enabled. 
A PHOTOPEN scan event is created by the operator performing the following actions: 

1. The operator points the PHOTOPEN to any position on the screen. 

2. The operator presses the PHOTOPEN to produce a PHOTOPEN switch interrupt. 

3. The operator observes a momentary flash as FSP displays a full screen of 
horizontal vectors to find the Y position and then a partial screen of 
vertical vectors to find the X position. 

The FSP programmer detects PHOTOPEN scan events by calling the EVENT routine 
and checking the returned event code for a value of 6. If a PHOTOPEN scan event is 
detected, then the FSP programmer must call the GETPXY subroutine which returns to 
the caller the following PHOTOPEN scan information: 

• Pen number 

• X, Y position of pen 
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16.1 ENTER PHOTOPEN SCAN MODE 



NAME: ENBPXY 

FUNCTION: Sets the operating characteristics of the PHOTOPEN selected to 
the scan mode. In this mode, the PHOTOPEN acts as a positional 
entry device and can be pointed to a blank screen. 

CALLING FORMAT: CALL ENBPXY (IPEN,ICRT) 

DESCRIPTION OF PARAMETERS: 

!1 = PHOTOPEN #1 activated 
2 ^ PHOTOPEN #2 activated 

ICRT = An integer variable specifying which indicator to scan. 

See STATUS for the values of ICRT and the corresponding 
displays. 

DETAILED DESCRIPTION: 

This subroutine results in nothing visual but simply sets the PHOTOPEN 
to the scan mode. While in this mode, any number of scan events are possible. 
Both PHOTOPENs may be in the scan mode. 



16.2 TERMINATE PHOTOPEN SCAN MODE 
NAME: DSAPXY 

FUNCTION: Sets the operating characteristics of the PHOTOPEN to the item 
mode. 

CALLING FORMAT: CALL DSAPXY (IPEN) 

DESCRIPTION OF PARAMETERS: 

( 1 = PHOTOPEN #1 deactivated 
IPEN = { 

' 2 = PHOTOPEN #2 deactivated 

DETAILED DESCRIPTION: 

This routine is normally visual in conjunction with ENBPXY. 
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16.3 REQUEST PHOTOPEN SCAN 



NAME: REQPXY 

FUNCTION: Leaves item mode and enters scan mode. Control is returned to the 
caller after a scan event has occurred. The item mode is then 
reestablished. 

CALLING FORMAT: CALL REQPXY (IPEN,ICRT) 

DESCRIPTION OF PARAMETERS: 

( 1 = PHOTOPEN #1 activated 
IPEN = < 

I 2 = PHOTOPEN #2 activated 

ICRT = An integer variable specifying which indicator to scan. 

See STATUS for the values of ICRT and the corresponding 
displays. 

DETAILED DESCRIPTION: 

This call is used to obtain a single scan event. The sequence of events 
performed by this call are as follows: 

(1) Scan mode selected (CALL ENBPXY) 

(2) Routine waits for operator to generate a scan event 

(3) Item mode is reestablished (CALL DSAPXY) 

To obtain the scan data, the FSP should call EVENT to verify an event 
code of 6 (PHOTOPEN scan) and then call GETPXY to obtain the X,Y position. 
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16.4 GET PHOTQPEN SCAN EVENT INFORMATION 
NAME: GETPXY 

FUNCTION: Retrieves from the event tables all information concerning the 
PHOTOPEN scan event. 

CALLING FORMAT: CALL GETPXY (IPEN,X,Y) 

DESCRIPTION OF PARAMETERS: 

!1 = PHOTOPEN #1 caused scan event (returned) 
2 = PHOTOPEN #2 caused scan event (returned) 

X,Y - Real variables in user coordinates indicating the X,Y 

position of the pen. 

DETAILED DESCRIPTION: 

Returns to the caller the P.HOTOPEN scan information associated with the 
last PHOTOPEN scan event. 



SECTION 17 



TRACKBALL /FORCESTICK/DATA TABLET ROUTINES 



This section describes how to program the trackball or forcestick or data 
tablet. 

The following routines are described in this section: 



TBALL 


- Enable FED events 


DISTB 


- Disable FED events 


DTINIT 


- Assign data tablet as a FED 


DTMODE 


- Select data tablet operating mode 


REQTB 


- Request FED X, Y 


GETTB 


- Get FED request information 



A device which is used to input an X, Y coordinate to FSF is called a positional 
entry device (FED). FSF supports the following FEDs: 

• Trackball 

• Forcestick 

• Data Tablet 

• FHOTOFEN (scan mode) 

NOTE 

The use of the FHOTOFEN as a FED is addressed in 
Section 16. 

FSF allows and supports up to two FEDs. A single FED system has the FED 
connected to port 4 of the first multiport serial interface. An additional FED 
may be added, and is connected to port 8 of the second multiport serial interface. 
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Multiport serial #1 



PORT 


1 


PORT 


2 


PORT 


3 


PORT 


4 



" PED #1 (trackball or forcestick or data tablet) 



Multiport serial #2 



PORT 


5 


PORT 


6 


PORT 


7 


PORT 


8 



" PED #2 (trackball or forcestick or data tablet) 



FSP, when initialized (GSS4 call), assumes the PED s to be either a trackball 
or a forcestick (default). A call to DTINIT and DTMODE is required if the PED or 
PEDs are data tablets. Following initialization, the X, Y position of the PED is 
set to the center of the screen. 

A PED event is created when one of the following operator actions or program 
actions take place: 

• REQTB subroutine is called (synchronous event) 

• The data tablet pen is pressed and released while in the automatic 
mode (asynchronous event) . 

The information available as a result of a PED event is as follows: 

• PED causing the event (1 or 2) 

• X, Y coordinate of the PED in user coordinates. 

The subroutine GETTB is used to obtain the above information once the event 
has occurred. 



An additional PED feature is provided by the TBALL subroutine which locks a 
visual cursor to the movement of the PED; i.e., as the PED is moved, so is the 
visual cursor. 
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The following operator and/or program actions are required to use a FED: 

(1) Enable FED and link FED movement to visual cursor (TBALL) 

(2) Change f orcestick/trackball default condition if FED is a data tablet 
(DTINIT and DTMODE) 

(3) Move FED to desired X, Y coordinate (operator action). 

NOTE 

Visual cursor follows FED movement, 

(4) Request and get FED X, Y position (REQTB, EVENT, GETTB) 
or, if FED is a data tablet in the automatic mode, 

(4a) Get last FED position (EVENT, GETTB). 
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17.1 ENABLE PED EVENTS 



NAME: TBALL 

FUNCTION: Link PED movement to visual cursor and enable PED events. 

CALLING FORMAT: CALL TBALL (ITBALL, IPAGE, MARK) 

DESCRIPTION OF PARAMETERS: 

ITBALL = Integer variable supplied by caller indicating the desired 
PED. 

1 = PED #1 

2 = PED #2 

IPAGE = Page number containing user defined symbol. If 0, a default 
symbol is used ("^" for PED #1 and for PED #2) 

MARK = The location of the absolute move preceding the symbol. If 
IPAGE = 0, MARK is used to establish the indicators on which 
the default symbol is to be displayed (1 thru 15 ~ see STATUS 
for the values which correspond to the indicators). 

DETAILED DESCRIPTION: 

TBALL enables PED events and as such must be called before using the PED. 
In addition to enabling PED events, a default visual indicator is placed on 
the screen for PED #1 and for PED #2) . As the PED is moved (pen 

pressed on the data tablet) , the cursor moves also to indicate the current 
X, Y position of the PED. 

This routine also allows the user to link the PED to a MOVE absolute 
instruction in his page whose X, Y parameters will be modified in response to 
movement of the PED, The user should obtain the mark (REQMRK and GETMRK) of 
the MOVE absolute instruction before calling MOVE. 

Following the absolute MOVE call, relative graphic instructions (TEXT or 
relative DRAWS) should be inserted. Now, when the absolute MOVE is updated, 
all of the relative vectors move also. 
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17.2 DISABLE PEP EVENTS 
NAME: DISTB 

FUNCTION: Disconnects linkage between PED and visual cursor and disables 
PED events. 

CALLING FORMAT: CALL DISTB (ITBALL) 

DESCRIPTION OF PARAMETERS: 

ITBALL = Integer variable supplied by caller indicating the desired 
PED. 

1 = PED #1 

2 = PED #2 

DETAILED DESCRIPTION: 

This routine reverses the action of a call to TBALL and no PED events 
are possible. 

17.3 ASSIGN PED AS A DATA TABLET 
NAME: DTINIT 

FUNCTION: Informs FSP that a data tablet is present. 

CALLING FORMAT: CALL DTINIT (IPEDNO) 

DESCRIPTION OF PARAMETERS: 

IPEDNO = Integer variable supplied by the caller indicating which 
PED position the data tablet is connected to. 

1 = Connected to PED 1 position (port 4) 

2 = Connected to PED 2 position (port 8) 

DETAILED DESCRIPTION: 

This routine must be called if a data tablet is present and should be 
called following the TBALL call. If not called, a trackball or forces tick 
is assumed, which will result in incorrect data when the data tablet is used. 

NOTE 

Data tablet messages are 10 characters in length. 
Trackball/f orcestick messages are 2 characters in 
length. This call must be immediately followed by 
a 'Vail" to DTMODE to select the "request" or 
"automatic" mode. 
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SELECT DATA TABLET OPERATING MODE 



NAME: DTMODE 

FUNCTION: Define the operating mode for the data tablet. 

CALLING FORMAT: CALL DTMODE (IPEDNO, IMODE) 

DESCRIPTION OF PARAMETERS: 

IPEDNO = Integer variable supplied by the caller indicating which 
data tablet the mode change refers to« 

1 = Data tablet #1 (port 4) 

2 = Data tablet #2 (port 8) 

IMODE = Integer variable supplied by the caller used to select the 
operating mode for the data tablet. 

0 - Request mode 

1 = Automatic mode 

DETAILED DESCRIPTION: 

This subroutine establishes the operating mode for a data tablet* There 
are two operating modes: the request mode and the automatic mode. In the 
request mode, data tablet X, Y position data messages are generated only in 
response to a REQTB call. In the automatic mode, data tablet X, Y position 
data messages are generated any time the user releases (for at least h second) 
the switch on the data tablet pen (after it has been pressed). For both 
modes, the user calls EVENT to wait for the terminal response and then calls 
GETTB to obtain the values. 



17.5 PED PROGRAMMING EXAMPLES 



Example 1 C Initialize forcestick as PED #1 using 
C default cursor on display #1 



CALL GSS4 

CALL LAYOUT 

CALL TBALL (1,0,1) 



C At this point in the program an "^'f" appears 

C on display #1 in the center of the screen and 

C follows the operators actions on the 

C forcestick. No PED events are generated, 

C however, until the program issues a REQTB call. 

Example 2 - C Initializes data tablet as PED #1 in automatic 
C mode using default cursor on display #1 



CALL GSS4 

CALL LAYOUT 

CALL TBALL (2,0,2) 



C At this poifit a appears on display #1; 
C however, the data tablet is not ready for use 
C until the following two calls are made. 

CALL DTINIT (2) 
CALL DTMODE (2,1) 



C At this point in the program the operator 

C may move the only by moving the data 

C tablet pen with the switch pressed. Once the 

C switch is released, a PED event is created 

C which is detected by the EVENT call and 

C processed by the GETTB call - i.e., no REQTB is 

C required in this mode. Multiple PED events are 

C possible in the automatic mode simply by pointing 

C to a position on the tablet and pressing 

C and releasing the switch. 
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Example 3 - C Initialize trackball as PED #1 using 
C a user defined cursor on display #1 
C 

C Create a single page 50 words in length 

CALL GSS4 (1,0,1) 
CALL LAYOUT (1,50) 

C Define the cursor to be the letter "A" 

CALL MOVE (512., 512., 0) 
CALL TEXT (1,1HA) 

C Notes The mark associated with the above absolute 

C MOVE call is = 0 since nothing 

C else has been placed in the page. 

C Also the "A" is displayed at the center 

C ' of the screen but not under trackball control. 

C Link trackball to user defined cursor 

CALL TBALL (1,1,0) 

C At this point in the program the "A" is linked 
C to the trackball and is moveable. 



17-8 



17.6 REQUEST PEP X,Y 



NAME: REQTB 

FUNCTION: Requests the current X, Y coordinate of the specified PED. 

GALLING FORMAT: GALL REQTB (NUMBER) 

DESGRIPTION OF PARAMETERS: 

NUMBER = Integer variable supplied by the caller indicating the 
PED selected. 

1 = PED #1 

2 = PED #1 

DETAILED DESCRIPTION: 

This routine causes a PED event to occur which has an event code of 2. 
The PED event contains the current X,Y position of the PED as indicated by 
the current cursor position on the screen. This call should not be used if 
the PED is a data tablet in the automatic mode. 

NOTE 

This call only causes a PED event to occur. 
The actual X, Y position of the PED is ob- 
tained by a combination of the EVENT and GETTB 
subroutines. 
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17.7 GET PEP REQUEST INFORMATION 



NAME: GETTB 

FUNCTION: Retrieves the current X, Y coordinate of the FED. 

CALLING FORMAT: CALL GETTB (NUMBER 1 X, Y) 

NUMBER = An integer variable returned to the caller identifying 
the FED which caused the event. 

X, Y = Real variables containing the current location of the FED 
in user coordinates. 

DETAILED DESCRIFTION: 

This routine is called after the EVENT subroutine has returned an event 
code of 2 (FED event) . 

Example 1: C Read current FED #1 position 

CALL REQTB (1) 
10 CALL EVENT (lEVNT) 

IF (lEVNT .NE. 2) GO TO 10 
CALL GETTB (NUMBER, X, Y) 
IF (NUMBER .NE. 1) GO TO 10 

Example 2: C Read current FED //2 position where FED #2 
C is a data tablet in the automatic mode 
20 CALL EVENT (lEVNT) 

IF (lEVNT .NE. 2) GO TO 20 

CALL GETTB (NUMBER, X, Y) 

IF (NUMBER .NE. 2) GO TO 20 
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SECTION 18 



MISCELLANEOUS ROUTINES 



This section describes how to produce hard copies, how to request and sub- 
seqixently how to receive a block of refresh data, and how to obtain error codes 
curirently displayed on enabled display indicators. 

The following routines are described in this section: 

HCOPY - Initiate hard copy 

REQIM - Request refresh image 

GETIM - Receive refresh image 

GETERR - Get error information 
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18.1 INITIATE HARD COPY 



NAME: HCOPY 

FUNCTION: Initiates a hard copy of all data currently being directed to the 
fourth display (output channel #4) • 

CALLING FORMAT: CALL HCOPY (-1) 

DESCRIPTION OF PARAMETERS: 

"1 = Start hard copy indicator 

DETAILED DESCRIPTION: 

The STATUS call is used for selecting display #4 as the output channel. 
Approximately 7 seconds after this call is made, a hard copy event (event 
code 10) is generated to indicate the hard copy is complete and that a new 
copy may be initiated. 

Example: C Initiate hard copy and wait for 

C completion 

CALL HCOPY (-1) 
10 CALL EVENT (lEVNT) 

IF (lEVNT.NE.lO) GO TO 10 

A direct approach for obtaining a hard copy of an image is to select two 
indicators in the call to STATUS. The first indicator is the display on which 
the graphics is to appear and the second indicator is display #4 which is 
used for hard copy. 

Example: C Draw a line on display #1 and then 

C get a hard copy 

CALL GSS4 (1, 0, 1) 
CALL LAYOUT (1, 50) 
CALL STATUS (0, 7, 0, 9) 

NOTE 

The 9 in the above STATUS call selected 
indicators 1 and 4« 

CALL MOVE (512. , 512. , 0) 
CALL DRAW (1023. , 1023. , 0) 
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C Now initiate hard copy 
CALL HCOPY (-1) 

NOTE 

If the STATUS call in the above example had 
selected indicator 1 only, then a blank piece 
of paper would have been produced. The fol- 
lowing edit code would be required to obtain 
the copy: 

CALL UPDATE (1, 0) 

NOTE 

The mark associated with the STATUS call, 
since it is the first item in the page, is = 0 

CALL STATUS (0, 7, 0, 9) 
CALL HCOPY (-1) 



18,2 REQUEST REFRESH IMAGE 
NAME: REQIM 

FUNCTION: Initiates a request for a block of up to 20 words to be transferred 
from an opened page back to the host. 

CALLING FORMAT: CALL REQIM (NINST) 

DESCRIPTION OF PARAMETERS: 

NINST = Integer variable specifying the number of refresh data to 
be transferred starting at present mark. 

1 < NINST _< 20 

DETAILED DESCRIPTION: 

This routine causes an image event to occur which has an event code of 9. 
The image event contains up to 20 words of refresh code, starting at the 
current mark position supplied. The page is assumed to be the currently 
opened page. 
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18.3 GET REFRESH IMAGE 



NAME: GETIM 

FUNCTION: Retrieves from the event tables an array of data which is the 
refresh image code. 

CALLING FORMAT: CALL GETIM (lARRAY, ISIZE, NINST, IPAGE) 

DESCRIPTION OF PARAMETERS: 

lARRAY = An integer array supplied by the caller into which the refresh 
data is transferred. 

ISIZE = An integer variable supplied by the caller containing the 

maximum number of words of refresh data to be placed in the 
array; i.e., ISIZE is the size of the array* Any data in 
excess of the limit is discarded. 

NINST = An integer variable returned to the caller specifying the 
number of words of refresh data transferred. 

IPAGE = An integer variable returned to the caller identifying the 
page number from which the data was transferred. 

DETAILED DESCRIPTION: 

The REQIM routine initiates this event; the EVENT subroutine detects the 
event and this routine retrieves the data. 

Example: C Read 10 words from page 3 starting at 

C mark 5. 

DIMENSION lARRAY (10) 



CALL UPDATE (3,5) 
CALL REQIM (10) 
10 CALL EVENT (lEVNT) 

IF (IEVNT.NE.9) GO TO 10 

CALL GETIM (lARRAY, 10, NINST, IPAGE) 
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18.4 GET ERROR INFORMATION 



NAME: GETERR 

FUNCTION: Retrieves information concerning an error event 

CALLING FORMAT: CALL GETERR (lARRAY) 

DESCRIPTION OF PARAMETERS: 

lARRAY = A 4-word integer array supplied by the caller into which 
the 4-word error information is placed. 

lARRAY(l) = Error code 

IARRAY(2) = 0 

IARRAY(3) = 0 

IARRAY(4) = 0 

DETAILED DESCRIPTION: 

Detection of any of the error conditions described in Appendix C 
causes an error event (event code 8) . An error event is detected by the 
EVENT routine and this routine actually retrieves the error data. The error 
code is returned as two 8-bit ASCII characters right adjusted in lARRAY (1). 
These same two characters are displayed in certain cases in the upper left 
corner of the display. 

Example: CALL EVENT (lEVNT) 

IF (IEVNT.NE.8) GO TO 10 
CALL GETERR (I ARRAY) 
10 CONTINUE 
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SECTION 19 



PACKED VECTOR MODE 



The following subroutines are described in this section: 

ENBPMD - Enable packed vector mode 

PMOVE - Packed vector move 

PDRAW - Packed vector draw 

DSAPMD - Disable packed vector mode 

Packed vector mode is primarily intended for serial interface users. Using 
packed vector mode can result in a 4:1 speed increase when inserting absolute move 
and absolute draws into refresh. 

The packed vector mode feature is most useful when large amounts of X, Y move 
and draw data are being created over the serial interface. Packed vector mode can 
also be used on parallel interface systems but it is strongly recommended that 
packed vector messages not be used on parallel systems. No FSP internal ASCII code 
conversions are required for parallel transmissions and the use of packed vector 
messages on parallel systems will result in a decrease in speed due to the FORTRAN 
overhead involved in processing packed moves and draws. 

Calls to PMOVE and PDRAW data create packed vector data in an output buffer. 
When the buffer is filled, the data in the buffer is sent to GCP+ automatically. 
An important function of DSAPMD is to insure that no residual data is lost by send- 
ing the contents of the output buffer to GCP+. 

NOTE 

Once packed vector mode is enabled by calling 
ENBPMD, the only calls allowed to FSP are to PMOVE, 
PDRAW, and DSAPMD. 
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Sample user program segment: 



C 

C REFRESH CODE FOR DRAWING BARRED BOX 

C 

X = XCOORD 

Y = YCOORD 

XRIGHT = XCOORD +128. 

C 

C ENABLE PACKED VECTOR MODE 
C 

CALL ENBPMD 

C 

DO 40 M = 1, 64 

Y = Y + 2. 

CALL PMOVE (X, Y) 
CALL PDRAW (XRIGHT, Y) 
40 CONTINUE 

C 

C DISABLE PACKED VECTOR MODE 
C 

CALL DSAPMD 

C 



19.1 ENABLE PACKED VECTOR MODE 
NAME: ENBPMD 

FUNCTION: This routine enables the packed vector mode. 

CALLING FORMAT: CALL ENBPMD 

DESCRIPTION OF PARAMETERS: None 

DETAILED DESCRIPTION: 

This routine enables the packed vector mode, allowing the user to send 
graphic absolute move and draw commands in packed mode. ENBPMD must be 
called before the PMOVE, PDRAW, and DSAPMD routines may be called. Once 
packed vector mode is enabled, any number of calls to PMOVE and PDRAW and 
one call to DSAPMD are allowed. No other FSP subroutines may be called while 
in packed vector mode. A call to DSAPMD is required to disable packed 
vector mode. 
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19.2 PACKED VECTOR MOVE 



NAME : PMOVE 

FUNCTION: Allows the caller to move the CRT beam to a desired absolute 
X, Y position in user coordinates while in packed vector mode. 

CALLING SEQUENCE: CALL PMOVE (X, Y) 

DESCRIPTION OF PARAMETERS: 

X, Y = Real variables specified by the caller indicating the 

absolute X, Y user coordinate to which the beam is to be 
moved. (Note: X and Y must be in the range specified 
in the user's call to SCALE.) 

DETAILED DESCRIPTION: 

PMOVE operates similarly to the FSP subroutine MOVE in absolute mode 0 
(paragraph 10.1). The beam is moved to the X, Y coordinate specified by 
the caller. The X, Y coordinate then becomes the current beam position. 

PMOVE converts the absolute X, Y user coordinate into a display coordinate, 
formats (packs) the X, Y data for transfer to GCP+, and causes an absolute 
move graphic order to be inserted at the mark position of the currently 
opened refresh page. PMOVE may be called only when packed vector mode is 
enabled (see ENBPMD) . 

The sample user program segment at the introduction to this section 
illustrates a use of PMOVE. 
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19.3 PACKED VECTOR DRAW 



NAME: PDRAW 

FUNCTION: Allows the user to draw a line (vector) from the current CRT 

beam position to the absolute X, Y position in user coordinates 
while in packed vector mode. 

CALLING FORMAT: CALL PDRAW (X, Y) 

DESCRIPTION OF PARAMETERS: 

X, Y = Real variables specified by the caller indicating the 

absolute X, Y position in user coordinates while in packed 
vector mode, 

DETAILED DESCRIPTION: 

PDRAW operates similarly to the FSP subroutine DRAW in absolute mode 0 
(paragraph 10.2). A line is drawn from the current beam position to the 
X, Y coordinate specified by the caller. The X, Y coordinate then becomes 
the current beam position. 

PDRAW converts the absolute X, Y user coordinate into a display coor- 
dinate, formats (packs) the X, Y data for transfer to GCP+, and causes an 
absolute draw graphic order to be inserted at the mark position of the currently 
opened page. PDRAW may be called only when packed vector mode is enabled 
(see ENBPMD) . 

The sample user program segment at the introduction to this section 
illustrates a use of PDRAW. 



19-4 



19,4 DISABLE PACKED VECTOR MODE 



NAME: DSAPMD 

FUNCTION: Disables packed vector mode by changing the FSP operating mode 
from packed vector mode back to standard FSP call mode. 

CALLING FORMAT: CALL DSAPMD 

DESCRIPTION OF PARAMETERS: None 

DETAILED DESCRIPTION: 

Once packed vector mode has been enabled by a call to ENBPMD, a call 
to DSAPMD must be made before calls to any other non-packed vector mode 
routines. 

This routine also insures that residual packed vector data will be sent 
(see introduction to this section) . 



19-5 



I 
I 
I 
I 
t 
I 
I 
1 
1 
I 
1 
I 

I 
I 
t 
I 
I 
I 
( 



SECTION 20 



COORDINATE CONVERTER ROUTINES 



Four subroutines enable the programmer to manipulate the coordinate converter. 
They are: 

CCINIT - Initialize coordinate converter 

CCVAL - Activate the coordinate converter with specific values 
CCON - Turn on the coordinate converter 



CCOFF 



- Turn off the coordinate converter 



These subroutines enable the user to selectively rotate and translate a par- 
ticular segment of the image, multiple segments of the image, or the total image 
displayed on the screen. For example, the picture displayed may have one part ro- 
tated 90 degrees, another 310 degrees, another 45 degrees, and another not rotated 
at all. The rotation can be performed around any point of the screen. This is 
made possible by positioning the point upon which an image is to be rotated at the 
center of the screen, rotating the image to the desired angle (0.2 degree resolu- 
tion), and then translating the image to the position desired. For example, say 
the picture the programmer wants to display is as shown in figure 20-1. 



.(500.0, 500.0) 



CENTER OF CIRCLE = 
(-200.0, 230,0) 




(-500.0, -500.0) 



CENTER = (0.0, 0.0) 



Figure 20-1 
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The picture contains three objects drawn at different positions and angles 



Object 1: + 

Object 2: 270 90 (drawn at 90°) 

Object 3: GSS-4 (drawn at 310°) 

Object 1 is a small cross, not rotated, drawn at the center of the screen. 
Object 2 requires the coordinate converter. An example of the code necessary to 
rotate and position object 2 is as follows: 

CALL CCVAL (0, 90.0, -200., 230. ,0) 

CALL MOVE (0. , 0. , 0) 

CALL CIRCLE (50.0, 0) 

CALL MOVE (-150., 0.0, 0) 

CALL TEXT (3, IT270) (IT270 = array of text '270') 

GALL MOVE (100.0, 0.0, 0) 

CALL TEXT (2, IT90) (IT90 = array of text '90') 

CALL CCOFF (0) 

Pictorially, the events that take place are as follows: 

1. First, the image is drawn around the origin as specified by calls to 
MOVE, CIRCLE and TEXT. See figure 20-2. 



(-150.0, 0.0) 




(500.0, 500.0) 



(50.0, 0.0) 



(100.0, 0.0) 



(-500.0, -500.0) 



Figure 20-2 
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The coordinate converter rotates the image 90 degrees as specified 
by an argument to subroutine CCVAL. See figure 20-3. 



(500.0, 500.0) 




(-500.0, -500.0) 



Figure 20-3 



The coordinate converter then translates object 2 to the position 
specified by the arguments to CCVAL. See figure 20-4. 



(-200.0, 230.0) 
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Figure 20-4 



Case 1 box translated 

to (100.0, 100.0) 



Case 2 - box translated 

to (100.0, 100.0) 




(500.0 , 500.0) 



(100.0, 100.0) 
(0.0, 0.0) 




(500.0, 500.0) 



(100^0, 100.0) 
(0.0, 0.0) 



(-500.0, -500.0) 



(-500.0, -500.0) 



A - OFFSET DISTANCE 
B - TRANSLATION DISTANCE 



Figure 20-10 



Figure 20-11 



In case 1, the box ends up rotated about the point (100.0^ 100.0). In case 2 
the box ends up rotated and translated with respect to the center of the screen. 

Four display registers are associated with the coordinate converter. Two 
control the angle of rotation: cosine and sine register; and two control the trans 
lation positions: X translation coordinate and Y translation coordinate. Four ^ 
refresh commands load these registers and another command controls activating or 
deactivating the coordinate converter. Each command advances the mark by 2. 
A detailed description of the four FSP subroutines that manipulate the coordinate 
converter are presented on the following pages. 



20-6 



20.1 INITIALIZE COORDINATE CONVERTER 



NAME: CCINIT 

FUNCTION: Initialize the coordinate converter to a standard initial state. 

CALLING FORMAT: CALL CCINIT (XCEN, YCEN) 

DESCRIPTION OF PARAMETERS: 

XCEN = A floating point variable returned to the caller specifying 
the X-coordinate of the center of the display in user 
coordinates. 

YCEN = A floating point variable returned to the caller specifying the 
Y~coordinate of the center of the display in user coordinates. 

DETAILED DESCRIPTION: 

This subroutine initializes the coordinate converter to the following 
initial state: 

X translation = 0 

Y translation = 0 

Angle = 0 degrees 

The returned parameters specify the location upon which all rotation 
occurs before translation. This subroutine advances the mark by 10. 
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20.2 ACTIVATE THE COORDINATE CONVERTER WITH SPECIFIC VALUES 



NAME: CCVAL 

FUNCTION: Inserts values into the coordinate converter registers and 
activates the coordinate converter. 

CALLING FORMAT: CALL CCVAL (K, ANGLE, XTRAN, YTRAN, IREL) 

DESCRIPTION OF PARAMETERS: 

' K = An integer constant defining angle format* 

0 * « angle in degrees 
1 • . angle in radians 

ANGLE - Angle of rotation in degrees or radians. 

XTRAN = X position of translation. 

YTRAN = Y position of translation. 

IREL = Specifies (XTRAN, YTRAN) format 

0.. absolute position 

1.. relative position from center 

DETAILED DESCRIPTION: 

All refresh data following this call, until another CCVAL or CCOFF call, 
is rotated and translated by the coordinate converter to the values the caller 
specified. This subroutine advances the mark by 10. 
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20.3 TURN ON THE COORDINATE .CONVERTER 



NAME : CCON 

FUNCTION: Activates the coordinate converter. 

CALLING FORMAT: CALL CCON 

DETAILED DESCRIPTION: 

This subroutine activates the coordinate converter. The values the 
coordinate converter responds to would have been previously set by calls to 
CCVAL or CCINIT. All refresh data following this call, until another CCVAL 
or CCOFF call, is rotated and translated by the coordinate converter to the 
values previously specified. To deactivate the coordinate converter, or change 
its values, the user would call CCOFF or CCVAL, respectively. This subroutine 
advances the mark by 2. 



20.4 TURN OFF THE COORDINATE CONVERTER 
NAME : CCOFF 

FUNCTION: Deactivates the coordinate converter. 

CALLING FORMAT: CALL CCOFF 

DETAILED DESCRIPTION: 

This subroutine deactivates (turns off) the coordinate converter. All 
following calls to FSP are not affected by the coordinate converter. The 
values set in the coordinate converter registers remain intact and may be 
reactivated or modified by calls to CCON or CCVAL, respectively. The mark is 
advanced by 2. 



f 
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SECTION 21 



IMAGE CONTROL ROUTINES 



There are two image control routines available to the FSP programmer: CLIP, 
which is used to eliminate graphic data that lies outside a user specified window, 
and SMOOTH, which is used to smooth lines by eliminating changes in direction too 
small to be visible. These routines require no special hardware, but rather all of 
the operations are done in software on the host computer. Using these routines, the 
user is able to preprocess his graphic data before shipping it to the GRAPHIC 7 via 
the FSP subroutine calls. 

CLIP 

It is often desirable to define a box in the viewing area in which an image is 
to be confined. This requires that the user guarantee that all graphic instructions 
which move the beam (MOVE,DR\W) do not cause data to be displayed outside of the 
selected window. By using the Sanders-supplied CLIP subroutine, the FSP programmer 
is relieved of the burden of performing his own slope calculations to guarantee that 
all data intersecting with the window boundaries do not cross outside. Refer to 
paragraph 21.1 for a description of the CLIP routine. 

SMOOTH 

The smooth routine is used to remove 'kinks' in a line composed of a series 
of connected lines whose changes in direction with respect to one another are too 
small to be seen. In many cases, this routine reduces the amount of data required 
to 'refresh' the image (by collecting several 'draws' into one 'draw') and causes 
a clearer looking plot by smoothing out the line. See paragraph 21.2 for a descrip- 
tion of the SMOOTH routine. 

NOTE 

Please refer to examples 4 and 5 in Appendix E 
for sample FSP programs demonstrating the use 
of the CLIP and SMOOTH subroutines. 
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21.1 REMOVE OFF-SCREEN DATA 



NAME: CLIP 

FUNCTION: Eliminates lines and graphic data that lie outside a user specified 
window. 

CALLING FORMAT: CALL CLIP (lOP, XI, Yl, X2, Y2, XLC, YLC, XUC, UYC, XPOSB, 
YPOSB) 

DESCRIPTION OF PARAMETERS: 
If lOP =1, 

then XI, Yl = are supplied by the caller to 'CLIP' as candidates for a beam 
positioning command (MOVE) . CLIP checks these values and 
determines if they lie within the window described by (XLC, 
YLC) and (XUC, YUC). lOP is returned as follows: 

8 » (XI, Yl) lie outside the window. No action should be 

taken by the caller on these coordinates. 

9 - (XI, Yl) lie within the window. The caller may call 

'MOVE' to position the beam to (XI, Yl). 

NOTE 

X2, Y2 are not used. 

If lOP = 2, 

then X2, Y2 = are supplied by the caller as the end point of a vector to be 
drawn having as its start point the current beam position. 
CLIP determines how much, if any, of the vector will be 
visible within the specified window. lOP is returned as 
follows: 

7 - the start point of the vector is within window. 

Call DRAW using X2, Y2. 

8 - the vector lies entirely outside the window and therefore 

should not be drawn. (No action should be taken by the 
caller.) 

9 - the start point of the vector lies outside the window. 

The user should call MOVE using XI, Yl to move the beam 
within the window boundaries. A call to DRAW using X2, 
Y2 will then display the visible portion of the vector. 
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(XLC, YLC, XUC, YUC) = window limits in user coordinates, 

XLC = X lower left corner 
YLC = Y lower left corner 

XUC = X upper right corner 
YUC = Y upper right corner 

(XPOSB, YPOSB) = current beam position. These are used to keep track of the 

current beam position, and should be the same two variables 

on each call to CLIP. These are neither set nor used by the 
user. 
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21.2 SMOOTH DISPLAYED LINES 



NAME: SMOOTH 

FUNCTION: This; subroutine straightens lines whose kinks are too small to be 
noticeable on the screen, thus saving room in the display buffer. 

CALLING FORMAT: CALL SMOOTH (lOP, X, Y, ISAVE, XSAVE, YSAVE, MSAVE, EPS) 

DESCRIPTION OF PARAMETERS: 

1. lOP = 1: Line break. This call initializes the subroutine. 

X and Y are not used. 

2. lOP = 2: New point. X and Y represent a new point in the current line. 

3. lOP = 3: Line end. This call indicates that the last point has been 

appended to the current line. X and Y are not used. This 
call forces out a point. The next call can be with lOP = 2 
to continue the line or with lOP = 1 to start a new line. 

On return, lOP, X and Y are set as follows: 



1 . lOP = 4 

2. lOP = 5 

3. lOP = 6 

4. lOP = 7 



No action required. 

Call MOVE to move the beam to X, Y. 

Call DRAW to draw a line from the present beam position to X, Y. 
Parameter error - lOP not 1-3. 



The "line break" call always returns lOP = 4 and the "line end" call 
never returns lOP =5. 

The parameter ISAVE is used internally to remember how many points are 
being buffered, and should be the same variable on each call to SMOOTH. 
XSAVE and YSAVE are real arrays of length MSAVE which are used to buffer data 
points. Each call to SMOOTH should pass the same two arrays. EPS is the 
amount of excursion from a straight line that will cause the line to be broken. 
To avoid any change in the screen image due to smoothing, EPS should be set 
to the screen resolution, which is 0.0009765625 (1/1024) of full screen width 
for the GRAPHIC 7. In user coordinates, screen width is the difference between 
the first and third (or second and fourth) arguments to SCALE. Smaller values 
of EPS may use more display buffer at the expense of making the picture less 
precise. If EPS is set to 0.0, SMOOTH produces output identical to its input 
with the exception of eliminating adjacent coincidental points. 
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SECTION 22 
FSP INPUT /OUTPUT 



Four subroutines are used by FSP for performing I/O to the GRAPHIC 7 terminal. 
They are: 

G7INIT - Initialize host/GRAPHIC 7 I/O driver 

G7TERM - Terminate host/GRAPHIC 7 I/O driver 

MSGOUT - Output message to GRAPHIC 7 terminal 

MSGIN - Input message from GRAPHIC 7 terminal 

The calling sequences for these subroutines are defined by Sanders > but the 
actxial routines themselves are supplied by the customer, i.e., Sanders does not pro- 
vide the host software necessary to perform the actual I/O (see figure 1, page 1-3) 
unless special arrangements have been made. 

FSP OUTPUT 

Most of the FSP subroutines, when called, perform the following functions: 

a. Create a message (header plus data) and place it in an output block* 

b. Call MSGOUT to transmit the message to the GRAPHIC 7 terminal for 
execution. 

FSP INPUT 

The graphic control program enhanced (GCP+) in the GRAPHIC 7 sends data 
to the host when polled by the host, i.e., PHOTOPEN, keyboard, and PED 
events are sent to the host only on request. A poll request and response 
sequence works as follows: 

CALL MSGOUT - Outputs a POLL request to GRAPHIC 7 

CALL MSGIN - Read POLL response from GRAPHIC 7 

FSP then analyzes the POLL response message and updates internal tables 
accordingly. 
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22.1 INITIALIZE HOST/GEAPHIC 7 1/0 DRIVER 
NAME: G7INIT 

FUNCTION: To initialize the host /GRAPHIC 7 1/0 driver. 
CALLING FORMAT: CALL G7INIT (lUNIT) 
DESCRIPTION OF PARAMETERS: 

lUNIT = An integer variable containing the device number associated 
with the GRAPHIC 7 in the call to the GSS4 subroutine. 



DETAILED DESCRIPTION: 

The calling sequence for this routine is defined by Sanders, but the actual 
routine itself must be supplied by the customer, ^^^f , ^^J^f 
directly by the application program, but rather is called internally by FSP 
as a result of the call to GSS4 subroutine. 

For parallel hosts, when the application program makes a call to the FSP 
subroutine, several functions are performed to initialize the GRAPHIC 7 ter- . 
minal to FSP mode. One function is to logically connect the application 
program with the GRAPHIC 7 within the architecture of the host operating 
system. The actual operations needed to perform the connection are host- 
dependent. Internal to the GSS4 subroutine a call is made to the G7INIT sub- 
routine to provide the customer with a mechanism for performing the I/O 
driver initialization process. In terms of the GRAPHIC 7, the key function 
nerformed by G7INIT is to initialize (under program control) the terminal 
controller by pulsing the INIT control line to the GRAPHIC 7 parallel inter- 
face card. The INIT pulse resets the terminal controller to the system mode. 

NOTE 



The INIT control line is exposed at the host end. 

For serial hosts, the G7INIT subroutine is not needed. To eliminate 
compilation errors, the customer should write a dummy G7INIT subroutine that 
only has a return statement. 

For example: SUBROUTINE G7INIT (lUNIT) 
RETURN 
END 

For parallel hosts, the design of the G7INIT subroutine is influenced by 
the following factors: 

• Host word length (16, 24, 32, 36, etc.) 

• Host I/O system 

• Host operating system 

• GRAPHIC 7 I/O driver (provided by customer) 



22-2 



Any unrecoverable errors detected by this subroutine, I/O driver or 
operating system, should cause termination of the job with appropriate 
diagnostic messages. 

22.2 TERMINATE HOST/GRAPHIC 7 I/O DRIVER 
NAME: G7TERM 

FUNCTION: To terminate the host/GRAPHIC 7 I/O driver 

CALLING FORMAT: CALL G7TERM (lUNIT) 

DESCRIPTION OF PARAMETERS: 

lUNIT = An integer variable containing the device number associated 
with the GRAPHIC 7 in the call to the GSS4 subroutine. 

DETAILED DESCRIPTION: 

The calling sequence for this routine is defined by Sanders, but the 
actual routine itself must be supplied by the customer. This routine is not 
called directly by the application program, but rather is called internally 
by FSP as a result of the call to the GSS4 subroutine. 

For parallel hosts, when the applications program makes a call to the 
THEEND subroutine, several functions are performed to terminate the FSP mode 
of operation and to return the GRAPHIC 7 terminal to the TTY emulator mode. 
One function is to logically terminate the connection between the application 
program and the GRAPHIC 7. The actual operations needed to terminate the 
connection are host-dependent. Internal to the THEEND subroutine a call is 
made to the G7TERM subroutine to provide the customer with a mechanism 
for performing the I/O driver termination process. 

For serial hosts, the G7TERM subroutine is not needed. To eliminate 
compilation errors, the customer should write a dummy G7TERM subroutine 
that only has a return statement. 

For parallel hosts, the design of the G7TERM subroutine is influenced 
by the following factors: 

e Host word length (16, 24, 32, 36, etc.) 

• Host I/O system 

• Host operating system 

• GRAPHIC 7 I/O driver (provided by customer) 

Any unrecoverable errors detected by this subroutine, I/O driver or 
operating system, should cause termination of the job with appropriate diag- 
nostic messages. 
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22.3 OUTPUT MESSAGE TO GMPHIC 7 TERMINAL 



NAME: MSGOUT 

FUNCTION: Outputs a message to the GRAPHIC 7 terminal. 

CALLING FORMAT: CALL MSGOUT (lUNIT, IBUF, lELEMC) 

DESCRIPTION OF PARAMETERS: 

lUNIT = An integer variable containing the device number associated 
with the GRAPHIC 7 in the call to the GSS4 subroutine. 

IBUF = An integer array, each entry of which contains two 8-bit 
bytes (one element), right adjusted. 

lELEMC = An integer variable containing the number of elements in the 
array IBUF to be output. Control is returned to the caller 
only after all elements have been successfully transmitted. 

DETAILED DESCRIPTION: 

The calling sequence for this routine is defined by Sanders, but the 
actual routine itself must be supplied by the customer. This routine is 
not called directly by the application program, but rather is called 
internally as a result of calls to other FSP routines. 

This routine invokes the I/O driver and requests output via the approp- 
riate operating system call. 

The actual details of this subroutine depend on the customer's design 
and implementation. The design is influenced by the following factors: 

• Host word length (16, 24, 32, 36, etc.) 

• Host I/O system 

• Serial or parallel interface 

• Host operating system 

• GRAPHIC 7 I/O driver (provided by customer) 

NOTE 

In the serial mode, a "carriage return" must be 
appended to the data provided by the caller, i.e., 
MSGOUT sends to the GRAPHIC 7 each character sup- 
plied by the caller and then MSGOUT sends a car- 
riage return. The 8 bit code for a carriage 
return may be either of the following: 
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00001101 



or 

10001101 

Any unrecoverable errors detected by this routine, I/O driver or operat- 
ing system should cause termination of the job with appropriate diagnostic 
messages. 

22.4 INPUT MESSAGE FROM GRAPHIC 7 TERMINAL 
NAME: MSGIN 

FUNCTION: Inputs a message from the GRAPHIC 7 terminal. 

CALLING FORMATS: CALL MSGIN (lUNIT, IBUF, lELEMC) 

DESCRIPTION OF PARAMETERS: 

lUNIT = An integer variable containing the device number associated 
with the GRAPHIC 7 in the call to the GSS4 subroutine. 

IBUF = An integer array into which data received from the GRAPHIC 7 
will be placed. Data will be packed two 8-bit bytes 
(one element) per array entry. 

lELEMC = An integer variable containing the number of elements in the 
array IBUF to be filled. Control is returned to the caller 
only after all elements have been successfully received. 

DETAILED DESCRIPTION: 

The calling sequence for this routine is defined by Sanders, but the 
actual routine itself must be supplied by the customer. This routine is not 
called directly by the application program, but rather is called internally 
as a result of calls to other FSP routines. 

This routine invokes the I/O driver and requests input via the approp- 
riate operating system call. 

The actual details of this subroutine depend on the customer's design 
and implementation. The design is influenced by the following factors: 
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9 Host word length (16, 24, 32, 36, etc.) 

• Host I/O system 

• Serial or parallel interface 

• Host operating system 

• GRAPHIC 7 1/0 driver (provided by customer) 

NOTE 

In the serial mode, the GRAPHIC 7 terminates each 
message sent to the host with a carriage return. 
This carriage return should be stripped by MSGIN 
and not supplied to the caller as part of his message » 

Any unrecoverable errors detected by this subroutine, I/O driver or 
operating system, should cause termination of the job with appropriate 
diagnostic messages. 
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SECTION 23 
DELIVERABLE ITEMS 

The following FSP items are provided to the customer at installation time 

A. FSP Source Code 

The FSP subroutines are provided as interpreted source code in card 
deck form (029 keypunch) . 

B. FSP User's Manual 

C. FSP Sample Program 

A sample FSP demonstration program written in FORTRAN is provided as 
interpreted source code in card deck form (029 keypunch) . 
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SECTION 24 



INSTALLATION PROCEDURE 



The following steps must be taken by the customer before the FSP sample 
program may be run: 

A. The FSP subroutines (provided by Sanders) must be made part of the 
operating system subroutine library. 

B. A GRAPHIC 7 I/O driver must be written and made part of the 
operating system. 

C. The MSGOUT, MSGIN* G7INIT, and G7TERM subroutines must be written and 
made part of the operating system subroutine library. 

• D. A SETEXT subroutine must be written before the sample FSP program 
can be used. 

E. The FSP sample program must be compiled and link-edited to create 
a load module. 

NOTE 

The following installation-dependent source 
statements in the sample program must be changed 
before compilation. 

CALL GSS4 (IUNIT,0,IFACE) 

lUNIT must be set to the logical unit number 
assigned to the GRAPHIC 7 device driver. 

IFACE must be set to 1 for parallel interface, 
or set to 2 for serial interface. 

After the FSP sample program has been successfully run, the customer should 
consider making the following improvements: 

1. The INSERT, EXTRAC, and SHIFT subroutines should be rewritten in assembly 
language to improve overall system speed. For parallel users, when these 
routines are rewritten, the customer can expect to see improvements in 
the order of 50%. (I.e., if it takes 30 seconds to display an image on 
the CRT indicator using the FORTRAN versions of INSERT, EXTRAC, and 
SHIFT, then the same image should take about 15 seconds to display when 
using assembly language versions of these subroutines.) 
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For serial users, the speed improvements will only be reflected at the 
higher baud rates. No speed improvement will probably be seen when 
operating below 2400 baud. At 9600 baud, a speed improvement in the 
order of 15% to 30% can probably be achieved. 

2. The CKPOLL subroutine can be modified to minimize the use of system 
resources when running FSP programs. 

When the CKPOLL subroutine is delivered, it is configured to operate in 
a polling mode. The GRAPHIC 7 is also configured to ignore command 
header errors. The polling mode configuration (set up by Sanders) works 
in the following manner: 

1. FSP user calls EVENT 

2. EVENT sends a POLL message to the GRAPHIC 7 via MSGOUT. 

3. The GRAPHIC 7 receives the POLL message and does the following: 

A. Sends out the next message .in the 0/P buffer. 

B. If the 0/P buffer is empty, the GRAPHIC 7 returns a dummy 
message to indicate that no message is ready. (Normally 
messages get stored in the 0/P buffer in response to some 
operator inputs.) 

For this configuration, the host computer is looping in a constant event loop. 
(I.e., for every POLL message sent, the GRAPHIC 7 returns a message.) 

To minimize the number of host to GRAPHIC 7 messages, the CKPOLL subroutine 
can be modified so that the GRAPHIC 7 only sends a message back to the host com- 
puter when a new message is stored in the O/P buffer. 

For parallel users, this type of poll mode can be selected by changing the 
IPOLL variable to 1. For this mode, error detection can also be enabled by setting 
IPOLL to 9. (I.e., when IPOLL = 9, error detection is enabled and messages are 
sent from the GRAPHIC 7 to the host only when a new message is stored in the O/P 
buffer.) 

For serial users, this type of poll mode can be selected by changing the IPOLL 
variable to 1. For this mode, error detection can also be enabled by setting IPOLL 
to 9. For half-duplex serial transmissions, no problems should be encountered with 
an IPOLL value of 9. For full-duplex serial transmissions, echoing types or prob- 
lems can be encountered. (I.e. , when the host computer receives a message from the 
GRAPHIC 7, it echos it back to the GRAPHIC 7, which results in an endless loop of 
command header errors.) If error detection is enabled for full-duplex, then the 
user must write the MSGIN software in a way that ensures that no echoing of messages 
back to the GRAPHIC 7 occurs. 
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The CKPOLL subroutine can also be configured to operate in a special type of 
polling mode. In this mode, the sending of GRAPHIC 7 to host messages is controlled 
by a user designated special character. This mode works as follows: 

1. FSP user calls EVENT. 

2. EVENT sends a POLL message to the GRAPHIC 7 via MSGOUT. 

3. EVENT sends a special character to the GRAPHIC 7 to indicate that the 
host is set up to read in the next message from the GRAPHIC 7. 

4. When the GRAPHIC 7 receives the POLL message, it starts looking for the 
special character. When it detects the special character, it sends the 
next message back to the host. 

The special character type of polling mode is only applicable to serial users. 
This mode is used in cases where the host operating system can't get set up in 
time to receive incoming messages from the GRAPHIC 7. 

If the special character type of polling mode is used, then the ISPCHR vari- 
able should be changed to the customer-selected value. 

NOTE 

The CKPOLL subroutine can also be set up to oper- 
ate in a non-polling mode. In this mode the 
GRAPHIC 7 sends messages back to the host computer 
anytime there is a message in the 0/P buffer. Please 
refer to the IM initialize l/O message formats mes- 
sage for additional information on running FSP programs 
in a non-polling environment. The IM message is des- 
cribed in the GRAPHIC 7 GCP+ Programmers Reference 
Manual. 

Normally when the THEEND subroutine is called, the 
GRAPHIC 7 is returned to the full-duplex teletype 
emulator. If half -duplex is being used, the THEEND 
subroutine can be modified to return the user to the 
half-duplex teletype emulator as follows: 

Change IOUTB(2)=30884 to IOUTB(2)=30880 
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SECTION 25 



STARTUP PROCEDURE 



The following paragraphs assume the following: 

• All steps of the installation procedure have been performed. 

• The GRAPHIC 7 terminal is hardware-wise connected to the host. 

• All power is on and the brightness and contrast knobs on the display 
indicator are set properly. 

A. Press LOCAL button on front panel of the GRAPHIC 7 and observe built-in 
test pattern. Validate (using this pattern and its associated built-in 
diagnostics) that the terminal is in working order. 

B. Press the "RETURN" key on the keyboard (causes pattern to disappear and 
"B00M" to appear). 

C. Press "Y" key followed by "RETURN" key to enter teletype emulation mode. 
At this point the GRAPHIC 7 performs as a teletype emulator until such 
time that a FORTRAN/FSP program (e.g., FSP sample program) is executed in 
the host. The call to GSS4, when executed, causes GCP+ to enter the 
SYSTEM mode. GCP+ remains in the SYSTEM mode until a call to THEEND 

is made, at which time the teletype emulator is re-entered. 



NOTE 



Refer to the GRAPHIC 7 GCP+ Programmer's 
Reference Manual (H-79-0348) for more 
information on LOCAL mode features. 
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APPENDIX A 
ALPHABETICAL SUMMARY OF SUBROUTINES 



The following FORTRAN callable FSP subroutines are available to the application 
program in the host computer. 



PAGE 
11-15 
20-7 
20-8 



FSP SUBROUTINES 



SUBROUTINE 
ADDREF (IPAGE) 
CCINIT (XCEN, YCEN) 
CCVAL (K, ANGLE, XTRAN, 



DESCRIPTION 
Open page for adding refresh data 
Initialize coordinate converter 
Activate the coordinate converter with 







YTRAN, IREL) 


specific values 


20- 


9 


CCON 


Turn on the coordinate converter 


20- 


9 


CCOFF 


Turn off the coordinate converter 


10- 


8 


CIRCLE (RADIUS, IQUAD) 


Draw a circle 






n TP ^THP Yl VI Y9 Y9 

XLC, YLC, XUC, YUC, 
XPOSB, YPOSB) 


P<:»Tno\7A n ci n TT p^rt c\Pi1'!^ 


12- 


•7 


COLOR (ICOLOR, IND) 


Set display color 


11- 


■20 


COPYIM (MARKA, MARKB) 


Copy a block of graphic orders 


12- 


■2 


CPARM (ICSIZE, ICROT, ICSPAC) 


Set character parameters 


17- 


-5 


DISTB (ITBALL) 


Disconnect PED from symbol 


12- 


-3 


DP ARM (ISP, I SYNC, IPEN) 


Set display parameters 


10- 


-4 


DRAW (X, Y, MODE) 


Draw a vector 


9- 


-7 


DSABOX (IND) 


Turn border display off 


9- 


-8 


DSAERR (IND) 


Turn error display off 


14- 


-3 


DSAPAD (IKEY) 


Disable alphanumeric scratch pad 


15- 


-4 


DSAPEN (IPEN) 


Disable PHOTOPEN detection mechanism 


19- 


-5 


DSAPMD 


Disable packed vector mode 
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FSP SUBROUTINES (Cont.) 

PAGE SUBROUTINE DESCRIPTION 

16- 2 DSAPXY (IPEN) Disable PHOTOPEN scan 

17- 5 DTINIT (IPEDNO) Assign PED as a data tablet 

17- 6 DTMODE (IPEDNO, IMODE) Select data tablet operating mode 
9-7 ENBBOX (IND) Turn border display on 

9-8 ENBERR (IND) Turn error display on 

14- 2 ENBPAD (IKEY, IND^ Y, Enable alphanumeric scratch pad 

IMAX) 

15- 4 ENBPEN (IPEN) Enable PHOTOPEN detection mechanism 
19-2 ENBPMD Enable packed vector 

16- 2 ENBPXY (IPEN, ICRT) Enable PHOTOPEN scan 

11-16 ERASEP Erase from page mark to end of page 

13- 2 EVENT (lEVNT) Poll terminal for event or request 
22-2 G7INIT (lUNIT) Initialize host/GRAPHIC 7 I/O driver 
22-3 G7TERM (lUNIT) Terminate host/GRAPHIC 7 I/O driver 

18- 5 GETERR (lARRAY) Get error information 

18-4 GETIM (lARRAY, ISIZE, Get refresh image 

NINST, IPAGE) 

14- 4 GETKEY (KBD, KEY) Get function key event information 
11-17 GETMRK (M) Get mark request information 

15- 6 GETPEN (IPEN, IPAGE, MARK, Get PHOTOPEN event information 

ITYPE, ICPAGE, 
IBYTE, ITMNUM) 

16- 4 GETPXY (IPEN, X, Y) Get PHOTOPEN X, Y request information 

17- 10 GETTB (NUMBER, X, Y) Get PED request information 

14-3 GETTXT (lARRAY, ISIZE, Get text event information 

NCHAR, KBD) 

9-2 GSS4 (lUNIT, IDUM, IFACE) Initialize terminal to FSP mode 

18- 2 HCOPY (-1) Initiate a hard copy 
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FSP SUBROUTINES (Cont , ) 



PAGE SUBROUTINE 

15-5 ITEM (NUM) 

12-6 LAMPOF (KBD, LAMP) 

12-5 LAMPON (KBD, LAMP) 

9-3 LAYOUT (NPAGES, LNGARY) 

10- 2 MOVE (X, Y MODE) 

11- 18 MOVEIM (MARKER, MARKTO) 

22-5 MSGIN (lUNIT, IBUF, 

lELEMC) 

22-4" MSGOUT (lUNIT, IBUF, 

lELEMC) 



DESCRIPTION 
Set item number 
Turn keyboard lamp off 
Turn keyboard lamp on 
Define graphic page layout 
Move beam to the position specified 
Move a block of graphic orders 
Input message from GRAPHIC 7 Terminal 

Output message to GRAPHIC 7 terminal 
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PDRAW (X, Y) 


Packed vector draw 


11-16 


PICTUR (IPAGE) 


Graphic subroutine call 


19-3 


PMOVE (X, Y) 


Packed vector move . 


10-7 


POINT 


Dt csnl p noint" 

J-/ -L.O j-* _LCl d j^KJ JLLLL. 


10-9 


REFDAT (lARRAY, N) 


Transfer a block of graphic orders 


18-3 


REQIM (NINST) 


Request refresh image 


11-17 


REQMRK 


Request the present page mark 


16-3 


REQPXY (IPEN, ICRT) 


Request PHOTOPEN X, Y 


17-9 


REQTB (NUMBER) 


Request PED X, Y 


9-6 


SCALE (XL, YL, XL, YU) 


Define coordinates 


21-4 


SMOOTH (lOP, X, Y, ISAVE, 
XSAVE, YSAVE, 
MS AVE, EPS) 


Smooth displayed lines 


12-4 


STATUS (IBL, INT, IVT, IND) 


Set display status 


17-4 


TBALL (ITBALL, IPAGE, MARK) 


Connect PED to symbol 


10-6 


TEXT (N, lARRAY) 


Display text characters 


9-9 


THEEND 


Terminate FSP mode 


11-15 


UPDATE (IPAGE, MARK) 


Open page for editing refresh data 
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APPENDIX B 



ASCII CODES 
CONTROL 



nrTAT 

yJKj JLxxLi 






KFVR 1 


\p\p\p 




NTTT 


fa 


(h(h^ 




ovjn 


A 




(liO 


QTY 
D iA 


■R 




yjo 


Jill A 


P 


(h(hL 






"n 

u 








Hi 






A PIT 


17 


(h(f\l 


(hi 


■RFT 

DUiLj 


CI 


yjiyj 


\f)o 


DO 


ij 
n 






JlII 


T 

J. 




rji A 


T TP 


T 
J 






V 1 






(hr 


1717 


T 
Ij 






UK 


M 




(hv 


du 


IN 




(hv 


D 1 






1 (h 




Jr 




1 1 
i i 


UL» 1 




(hoi 


1 9 
1 z 


u\j z 


Ja. 


023 


13 


DC 3 


S 


024 


14 


DC4 


T 


025 


15 


NAK 


U 


026 


16 


SYN 


V 


027 


17 


ETB 


W 


030 


18 


CM 


X 


031 


19 


EM 


Y 


032 


lA 


SUB 


Z 


033 


IB 


ESC 




034 


IC 


FS 





ALTERNATE CODE NAMES 
NULL, CTRL SHIFT P, TAPE LEADER 
START OF HEADER, SOM 
START OF TEXT, EOA 
END OF TEXT, EOM 
END OF TRANSMISSION, END 
ENQUIRY, WRU, WHO ARE YOU 
ACKNOWLEDGE, RU, ARE YOU 
BELL 

BACKSPACE, FE0 
HORIZONTAL TAB, TAB 
LINE FEED, NEW LINE, NL 
VERTICAL TAB, VTAB 
FORM FEED, FORM, PAGE 
CARRIAGE RETURN, EOL 
SHIFT OUT, RED SHIFT 
SHIFT IN, BLACK SHIFT 
DATA LINK ESCAPE, DC0 
XON, READER ON 
TAPE, PUNCH ON 
XOFF, READER OFF 
TAPE, PUNCH OFF 
NEGATIVE ACKNOWLEDGE, ERR 
SYNCHRONOUS IDLE, SYNC 
END OF TEXT BUFFER, LEM 
CANCEL, CANCL 
END OF MEDIUM 
SUBSTITUTE 
ESCAPE, PREFIX 
FILE SEPARATOR 
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ASCII CODES (Cont) 



CONTROL 



OCTAL 


HEX 


CHARACTER 


KEYB. EQUIV. 


ALTERNATE CODE 


035 


ID 


GS 




GROUP SEPARATOR 


036 


IE 


RS 




RECORD SEPARATOR 


037 


IF 


US 




UNIT SEPARATOR 


040 


20 


SP 




SPACE, BLANK 


041 


21 


t 






042 


22 


II 






043 


■ 23 


# 






044 


24 


$ 






045 


25 


% 






046 


26 


& 






047 


27 


» 




APOSTROPHE 


050 


28 


( 






051 


29 


) 






052 


2A 








053 


2B 


+ 






054 


2C 






COMMA 


055 


2D 


- 




MINUS 


056 


2E 








057 


2F 


/ 






060 


30 


0 




NUMBER ZERO 


061 


31 


1 




NUMBER ONE 


062 


32 


2 






063 


33 


3 






064 


34 


4 






065 


35 


5 






066 


36 


6 






067 


37 


7 






070 


38 


8 






071 


39 


9 






072 


3A 








073 


3B 


I 






074 


3C 


< 




LESS THAN 
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{ 
1 
I 

r 

[ 
[ 
I 
I 
I 
I 
I 
I 
I 
1 
I 
I 
I 
I 



OCTAL 


HEX 


CHAI 


075 


3D 




076 


3E 


> 


(hll 


3F 


? 


100 


40 


@ 


101 


41 


A 


102 


42 


B 


103 


43 


C 


104 


44 


D 


105 


45 


E 


106 


46 


F 


107 


47 


G 


110 


48 


H 


111 


49 


I 


112 


4A 


J 


113 


4B 


K 


114 


4C 


L 


115 


4D 


M 


116 


4E 


N 


117 


4F 


0 


120 


50 


P 


121 


51 


Q 


122 


52 


R 


123 


53 


S 


124 


54 


T 


125 


55 


U 


126 


56 


V 


127 


57 


W 


130 


58 


X 


131 


59 


Y 


132 


5A 


Z 


133 


5B 




134 


5C 




135 


5D 





ASCII CODES (Cont) 
CONTROL 

KEYS. EQUIV. ALTERNATE CODE NAMES 



GREATER THAN 



SHIFT P 



LETTER I 



LETTER 0 



SHIFT K 
SHIFT L 
SHIFT M 
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ASCII CODES (Cont) 



CONTROL 

OCTAL HEX CHARACTER KEYS. EQUIV. ALTERNATE CODE NAMES 

f SHIFT N 

SHIFT 0, UNDERSCORE 
ACCENT GRAVE 



136 


5E 

_/ Xj 


A 


137 


* 5F 




1 4Gl 


60 


5 


141 


61 


3. 


142 


62 


b 


143 


63 




144 


64 


d 


145 


65 


6 


146 


66 


f 


147 


67 


& 


1 S(?i 

J- — » 


68 


h 




69 




152 


6A 




153 


6B 


k 


154 


6C 


1 


155 


6D 


m 


156 


6E 


n 


1 57 


6F 


Q 


1601 


70 


n 
F 


1 61 

J. O JL 


71 

/ X 


4 


162 


72 


IT 


163 


73 


3 


164 


74 




165 


75 


U 


1 66 


76 


V 


167 


11 


W 


17G1 


78 


X 


171 


79 


V 


172 


7A 


z 


173 


7B 


{ 


174 


7C 


1 


175 


7D 


} 


176 


7E 




177 


7F 


D] 



VERTICAL SLASH 
ALT MODE 
(ALT MODE) 
DELETE, RUBOUT 
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APPENDIX C 



ERROR CODES 



Errors encountered by FSP subroutines are relayed to the user in two ways : 
visiaally and under program control (see paragraph 1.5), 

FSP error codes fall in the following categories: 

1 . System errors 

A. Overload conditions 

B. Malfunctions 

2. Incorrect calling sequence 

3. User parameter errors 

4. Current defined page refresh exceeded 

5. Miscellaneous 

All of the FSP error codes require the user to correct the error described and 
rerun the user program. FSP continues to execute the user program after an error 
has occurred, but undefined results may be observed. 

The normal running error code is 00 and is displayed in the upper left corner 
of the indicator(s) unless modified by a call to ENBERR or DSAERR (see Section 9). 
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SYSTEM ERUORS 



Overload Conditions - the following errors are caused when GCPH- buffers 
are overloaded and GCP+ cannot accept messages from or send messages to 
the host. These errors are detected when the EVENT routine requests a 
message from the GRAPHIC 7. 



Error 
Code 

02 



Descriptioti^ 

GCP+ output buffer full-PED coordinates 
cannot be sent to the liost« 



Action Initiating 
The Request 

CALL REQTB 



03 
04 



GCP+ output buffer full-=-GCP error message 
cannot be sent to the host. 

GCP+ input buffer full-messages cannot 
be sent to GCP+ 



05 



GCP+ output buffer full-function key or 
A/N keyboard information cannot be 
sent to the host 



Pressing function 
or A/N. key (s) 



06 



GCP+ output buffer full-hardcopy status 
or PHOTOPEN data messages cannot be 
sent to the host 



CALL HCOPY or 
PHOTOPEN 



08 



GCP+ output buffer full-return image CALL REQIM 

cannot be sent to the host 



Malfunctions 

Error code 13 is caused by the user calling routine ERASEP to delete 
refresh code when the current mark is beyond the end of the defined 
page* This situation can be encountered in edit mode. 

The user should check the code before the offending call to ERASEP to 
insure that correct FSP edit commands have been used. 
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C-2. INCORRECT CALLING SEQUENCE 



The following errors are caused by calling routines out of sequence. The 
user should check the order of the code in his program for the incorrect 
sequences described below. 



Code 



Cause 



Routine Causing 
Error 



21 



FED is not connected to a symbol, 
check for call to TBALL to connect 
FED to a symbol. 



REQTB, DTMODE 



22 



Call made to packed vector routine 
before call to ENBPMD or successive 
calls to DSAPMD. 



PMOVE, PDRAW3 
DSAPMD 



99 



Error is caused when LAYOUT is called 
without first calling GSS4 routine or 
multiple calls to LAYOUT in the same 
routine. 



LAYOUT 



C-3. USER PARAMETER ERRORS 

The following parameter errors are detected in user calls to FSP routines. 
The user should reread descriptions and check calls to named routines for the 
described errors. 



Code Description Routine 

30 Page number out of range ADDREF 

31 Page number or mark out of range UPDATE 

32 Page number out of range FICTUR 

33 Specifications too large LAYOUT 

34 Symbol cannot be moved by FED, mark TBALL 
specified is out of range 

35 Lamp number out of range LAMFON, LAMPOF 

37 Number of words greater than 20 REQIM 

38 FED number out of range DTINIT, DTMODE 
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c-4. CURRENT DEFINED PAGE REFRESH EXCEEDED 



The following errors are caused by insufficient refresh on the page where the 
error is detected. The user should increase the offending page size in the 
call to LAYOUT and rerun the user's program. 

Routine Called when Refresh 



Code Overflow Occurred 

40 MOVE or DRAW 

41 TEXT 

42 CIRCLE 

43 POINT 

44 PICTUR 

45 CPARM 

46 DPARM 

47 STATUS 

48 TBALL 

49 REFDAT 

50 PMOVE or PDRAW 

51 COLOR 

52 ITEM 



C-5. MISCELLANEOUS 



Error Code 



60 
62 
63 
64 
65 
66 



Routine Causing Error 



HCOPY 

COPYIM 

COPYIM 

COPYIM 

MOVEIM 

MOVEIM 
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APPENDIX D 



MEMORY USAGE 

This table shows commonly used FSP user available subroutines which generate 
graphic orders in the GRAPHIC 7 memory. Note, however, that certain FSP internal 
routines may insert refresh in the user's pages. The number of words of refresh 
created by internal routines is relatively small for normal applications. 



FSP 
SUBROUTINE 


NUMBER OF (16 BIT) WORDS 
OF GRAPHIC 7 REFRESH 
MEMORY FILLED 


ASSOCIATED GRAPHIC ORDERS 
(See GRAPHIC 7 GCP-h Programmer's 
Reference Manual for further descrip- 
tion of the graphic orders mentioned.) 


MOVE 


0, 1, or 2 


Depending on optimization, sends approp- 
riate "load" and "move" sranhic orders. 


JL/XVClW 


0, 1, or 2 


Depending on optimization, sends approp- 
riate "move" and "draw" graphic orders. 


TEXT 


(NH-l)/2 


N = number of characters of text. 


POINT 


1 


Point plot graphic order 


CIRCLE 


2 


LDKX, DRKY 


CPARM 


2 


LDDP, LDTI 


DPARM 


1 


LDDP 


STATUS 


1 


LDDZ 


COLOR 


2 


LDRI and indicator/color 


ITEM 


2 


LDRI and item (ID) number 


CCINIT 


11 


HREF and LDRIs 


CCVAL 


11 


HREF and LDRIs 


CCOFF 


2 


LDRI and 0. 


CCON 


2 


LDRI and 2. 


PMOVE 


2 


{^see note) 


PDRAW 


2 max. per draw 


(*see note) 
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FSP 
SUBROUTINE 


NUiyiBER OF (16 BIT) WORDS 
OF GRAPHIC 7 REFRESH 
MEMORY FILLED 


ASSOCIATED GRAPHIC ORDERS 
(See GRAPHIC 7 GCP+ Prograiraner 's 
Reference Manual for further descrip- 
tion of the graphic orders mentioned.) 


PICTUR 
LAYOUT 


3 max. 


CALL address or HALT, LDRI combination 

Inserts one graphic "RETURN" per user 
page. 



*PMOVE and PDRAW are generally used to create large blocks of X, Y move and draw 
data. The number of words of refresh created is a function of the number of 
PMOVEs and PDRAWs executed and the amount of optimization of X, Y move and 
draw data. 
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APPENDIX E 



PROGRAMMING EXAMPLES 



EXAMPLE 1 

This example illustrates the use of subroutine calls GSS4, LAYOUT, SCALE and 
THEEND. 

C 

C EXAMPLE PROGRAM 1 

C 

DIMENSION LPAGES(5) 

DATA LPAGES /1000, 100, 100, 10, 10/ 

C INITIALIZE AND USE LOGICAL UNIT NUMBER 5. TRANSMISSION 

C WILL BE OVER THE PARALLEL INTERFACE 

C 

CALL GSS4(5,0,1) 

C 

C SPECIFY 5 PAGES OF USER DATA, EACH LENGTH BEING AS 

C DESCRIBED IN THE "LPAGES" DATA STATEMENT ABOVE. 

C 

CALL LAYOUT (5, LPAGES) 

C 

C SPECIFY ORIGIN AT THE LOWER-LEFT CORNER AND A LENGTH 

C AND WIDTH OF 1024. 

C 

CALL SCALE(0,0, 0,0, 1023. 0,1023.0) 

C 

C (THE BODY OF THE DISPLAY PROGRAM GOES HERE) 

C 

C 

C WE ARE DONE, SHUT DOWN THE DISPLAY. 

C 

CALL THEEND 

C 

C EXIT THE PROGRAM 

C 

CALL EXIT 
END 
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EXAMPLE 2 



This sample program, when executed, displays EXAMPLE 2~PICTURE 1 on the screen. 
It illustrates user calls to the following subroutines. 

GSS4 

LAYOUT 

SCALE 

ADDREF 

MOVE 

DRAW 

POINT 

PICTUR 

TEXT 

EVENT 

GETKEY 

In using these routines, it illustrates page linking and also the programming 
interaction with peripheral devices. 

NOTE 

After picture is displayed, to return to the TTY 
emulator, hit most upper right function key. 
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m——a 

THJS IS TEXT 



EXAMPLE 2 - PICTURE 1 
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.0.,010« •■ 

0e20ia C *»»«»»»ofl«?«««<r«.ir»ai»««*FSP" SAMPLE-2 ~ »«T»»»o9« «»«»»♦••»«»»* 

00302 C THIS SaHPLE: PROGRAM TESJS SOt^E OF THE: FEaTuRpS CF ThE FSP 
00 400 __C_rORTR.AN_PACjaGEV 

0050^ C " " " '' ^ 

006015 DIMENSION LP AGES ( ? } , I TEX ( 6 ) 
012,7012 DATA LPAGES /10ea 1 100 1 120 , i 0 • 10/ 

eZ60i2 c ' ' ' ' ~ ' 

00900 C INITiALiHE AND USE LOGICAt UMT NUMBER 5V TRANSMISSION 
3 U m C__W ILk_B E_0 V1.R_XH E _S ERlAU INTER F A CE 

,33^^00 c ' ' — — 

0i20^ CMl GSS4(5,0;2) 

0i30i2_ _C_ _ , 

0l'40l2 C SFEcTfy 5 PAGES OF IStH OATAi EACHTENGflT 

01500 C BEING AS OESCRIBEC IN THE 'l,PAGES« DATA STaTcHEKT ABOVEV 

0i600 _S 

01700 CAUL Layout (sTuPASEsl 



01800 C 

01900 C_SPECiFY ORIGIN AT THE UQWER lEFT C ORNER aNo A LENGTH 

020 00 C ANDl-ilDlH" Of 1024'; ^ ^ 

02100 C 

02200 CAL L S(;AL E{g. g|IZ»gilg23,,10 23i> 

02300 C ' ' 

0240B C THE FOLLOWING EXAHPLE ILLUSTRATES THE USES OF AODREF, 
02500__C_MOVE; DRAW, TEXT I POINT I PICTUR,E VENT, GETKEY 

02600 C NOTEi tEXT~lS-DrSPLAYE:0'-TrA"S--StJBROVriNriJNTi^ 

02700 C HOST COMPUTER WHICH IS A POP»10, THIS SUBROUTINE iS CALLED 
02800_ C 'SET EXT'V 

0'29"0'0 e ~ ^ ' — ■ ^ — 

03000 C OPEN PAGE 1 PQFT TC'P LEVEL ORAWiNfr, 

03100 _ C 

0-J-200- cAUTTocfWfrm 

03300 fl 

_03400 C POSITION TH E BEAM TO THE CENTER OF THE ScReEn 

0353F" C ' ■■ ~ ' 

03600 CALL MOVE{S12Vi51g,,0) 

03700 C 

"3^6 0"0 ~"c~im?nrA~SMALL box in pagh; g — 

03900 C NOTE THAT THESE MOVES ANO DRAWS ARE ALL RELATIVE 

04000 0 

g 4 J 0^ C^LL A0ORE7T21 

04200 C 

_0_4300 C_UP A NO RI G HT BY 5 

0440'0 Z — 

04500 CALL M0VE{5,i5|iiJ 

04600 C 

" 04700 C~KT5TfT"ST tmr~F01< 

04800 C 

04900 CALL DRAW{0, ,;40,il> 

""03^000"^ — ~e " ' — — " ■ — ^ — 

B51B0 C , 

05200 C BOTTOM OP BOX 

—0jzm'~Q ^ : ^ ^ ^ 

05400 CALL ORAW(b10Vi0iiI) 

05500 C 

" mm nreFT 'sTc e:~o7-tox 

05700 G 

05800 CALL_DR^A_W{0,,10,iU 

05900 e " " ~ ' ~~~ 

06000 C TOP OF BOX 



_06J00 C 

0 6 2 0 !3 " c aUu "d^ a w (iT , raVTl » 

06300 C 

06400 C RETURN TO CENTER 



06500 C 

06600 CALL H0VE<.;5,;-»5,il) 

06700 C 



"0 68 0 ^ C "PUT IT 0 TN T"I fr"TFE~crfrr5 R 

06900 C 

0 70 0 0 CA l.k_P Q.INT 

0'7100 C 

07200 C NOW GO BACK TO BUILDING PACE 1 
07300 C 



07400 CALL AWRXFll) ~ 

07500 C 

07600 C INSERT A SUBROUTINE CALL TO CUR LI TTLE BhxV THIS wIlL 

"07700 C^JHOWnTlN^TRE'CEfs-TETr-or-THr^CREEffi 

07800 C 

0790 0 CA LL PlCTgR{2) 

"0$e00 c " ■ 

08100 C DRAW A LINE FROM THE CENTER OF THIS BOX tO TwE RIGHT A LITTLE. 

0820 0 G 

083 02 "C A1Xl)RWT6F0T75T2T7rj 

08400 C 

_0 8 5 0 0 C NOW O RA W ANOTHER LITTLE BOX HERE',' 

e^jm c 

08700 CALL PICTURJ2) 

08800 C 



W9ffi3 — c~ PLACE yoME TE>r jgsT yEtow THE Boxfes: 

09000 C 

09100 CALL MOVEi50(lVi460,,0l 

C'ACC^SrTFXTPlTTIS 1,0 J 

09300 CALL SETEXTCIS TE!,0) 

09400 CALL SETEXTt 'XTM2) 

09600 C PICTURE SHOULD BE FINISHED NOW 
09700 C _ 

0 9 800 C USE TWr 'EVENT' RCUTlNt TO FIND A KeVB13MDnfff 
09900 C FROM FUNCTION KEY NUMBER 31 TO EXIT 
10000 C 

Terf013 JOT CALL EVENT(I) 

10200 C IF I IS 4 THEN A KEY WAS HlTi OTHER WISE Go RACK TO EVENT AND 
10300 C WAIT FOR ONEt 

T?rT0-0 ' " 

10450 WRITEd, 110)1 

10475 110 FORMATC EVENTI '|15> 

-U3 m c ^ 

10600 if(i;neV4)gc TO 100 

10700 C 

Traa-B — c-iTrcr~ci5tiir"HrRrTCR-KCYB0'»R0 hit', i^ox ao RrisnrKrr-KtJFetR 

12900 c 

11000 CALL GET K EYCKBDiKEY) 

■T1T00 C ' : 

11200 C NOW SEE IF IT WAS. KEY NUMBER 31', IF NOT isO BaCK TC 
11300 C EVENT AND WAIT FOR IT, 

-ium — T 



11500 IF{KEYVNEV31)CQ TC 100 

11600 C 

Tr700 — c WILL coMr'tiERr~rr-Kc Y'-si-wA g-w I T^-sa-N"cm"WF 1 Rr-ac-KET 

11800 C SHUT DOWN THE DISPLAY AND RETURN TO THE TTy pMULATOR, 
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__11900 _CALkJ'HE£M_ 

12000 END 

12100 C 

_1 2 2 0 0 C »<n> <nnnn> «ni » «<t#»«»in>SET£ X T SUBRQUT I N £ FflR ThE PDpt>l0»«««<f <nnt^<nni»»<nnf 

12300"" C 

12400 C SUBROUTINE TO PUT TEXT R I GHT. AO JUSTED iH 5lU ARRAY 

12500 C 

~'r26"00 C TFn"SQTRTuTTKr^ETrXT~ISn3SED-W-SETTffriSRRrf~TDff^^ 

12700 C IN THE FSP ATP. TEXT IS TRANSMITTED IN iN ARRAY WITH ONE 

_1280J0 C 7 3IT A SCII CHAPACTEH, RJGhT ADjUSTEOi lN_EACh EUEMENT',' 

12900 C MOST Or^THE TEXT fN THE FSP >TPls" CILlED "OS InG^SETEXT 

13000 C THE FORMAT ISj 

1310 0 C CALL_ SETEX1{»AAAAA',IA) _ _ ____ 

13200 C WHERE TA is the" roTAU'NUM0ER^OrTHARlC'^n^^^^ A fffi( 

13300 C OF 5 CHARACTERS SURROUNDEO BY SINGUE QuOTESi T|-IS EVOLED PROM 

13100 C THE POP-10 VHOSE 36 «IT WOROS HOUD 5 ASClI CHARACTERS'. TO SEND 

l'3500"' C A Text "STRING OF "H0R"e~TFAN~5~CHARA"CTE:Rs'i MlXE^SETEFAl— 

13600 C OF 5 CHARACTERS EACH WITH IA?0, THIS WtLl AGO 

13700 C THE 5 CHARACTERS TO THE END OF AN ARRAY. flN THE LAST CALI. 

"1T800 c To"TETO"T7"SET-TirnjuAirn'o^E~7mr~N'uflrER 

13900 C SETEXT DOES THE ACTUAl, CAUl. TO TH| TEXT SUsROtTlNE IN HCP 

14000 C WHEN THE USER IS DONE» 

14100 C 



14200 SUBROUTINE SETEXT { I WRD i J A > 

143 00 DIMENSION I AR'RA Y (g ) 1 1 ARY ( 100} 

14401 DATA 1AD71/ 

14500 IW0RO'?IWRD 

__14600 ITESTelWORD 

1 4700 ~C ^ ^ ^ ^ ~ 

14800 C THIS MOVES THE 5 ASCTI CHAR-'l BIT TO THE RfCHT TO HAKE 

1490 0 C IT RI GHT ADJU STED 

15000" "TWQTTDsTW OR Q/2 ""^ 

15100 C 

15200 C THE ARRAY GOES FROM 9 TO 1 BECAUSE THAT IS THE CRCER THE 

-±51sm — ir~~i;HA R"A C TETrs^"A RETR ETt FrETETTTROtr-t-W ORD — 

15400 00 100 IsliS 

15500 C 

~l5Tlf0 C TAKE THE 7 RIGHT B I TS>, THnsiEXT CH1^7?lJi:rm? 

15700 IARRAY($-ngIWCRDiAND,»177 

15800 ITEST^IWORO 
~Lf9m C SHTFT-mORO-RTGHT 7 «ITS TC GET THETUEyT GwAR RIGHT ADJUSTfDT 

l$e00 IWCR0»lW0RD/(2#«7) 

16100 C ^ 

- 16200 C THE PElP-10 TRUNCAtESi SO UCmNUE IF IwORD IS-Ptnrm 

16300 IF(lWORP,GE,e)C0 TQ 100 

16400 C 

~T'650B — c — rrTiT0T'TO5~TTrG'rrnET?r!rKr"sijRrn'HERr-TsTmnrTR^ 

16600 irnTEST.NE,IWCRD*(2«»7niW0RDf IwoRb-i 

1 6700 100 CONTINUE 

16900 C TRj^NSFER THE ASCII CHARACTERS TO THE OuTpUT ARRAY 

17000 00 101 J»li5 

-i7r0ir tah vtt'au r?: r<^R RiYxaT : 

17200 lACBlADtl . 

17300 101 CONTINUE 

TJJS^ jj ^ 

17500 C IF THIS IS JUST AN AOOITION TO THE QuTpUf aRRAV, RETURN 

_17600 IF{IA.EQ.0> RE T URN 

1770-0 Q- 

17800 C RESET lAD TO THE START OF" THE OUTPUT ARRAY 
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Jl 7.9 m L*D8 1 

l80'00 C 

1810a C SEND OUT TEXT 

18200 CALL TEXT(lAiIARV), 

18300 RETORN 
18400 END 
18500 C 



EXAMPLE 3 



This sample program, when executed, displays EXAMPLE 3 - PICTURE 1 on the 
screen* It illustrates user calls to: 

GSS4 

LAYOUT 

SCALE 

ADDREF 

MOVE 

DRAW 

POINT 

PICTUR 

TEXT 

EVENT 

GETKEY 

GETMRK 

REQMRK 

UPDATE 

ENBPEN 

DPARM 

CPARM 

The text "TEXT" is sensitive to PHOTOPEN strikes and will BLINK or NOT BLINK 
with successive PHOTOPEN hits. 

NOTE 

After full picture is displayed, to return 
to the TTY emulator, hit most upper right 
function key. 
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EXAMPLE 3 - PICTURE 1 
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02200 
00300 
00400_ 

008012 
00900 

01000 

"0~U00"' 

01200 

0l300_ 

01400 

01500 
_016_00 

01701^ 

01800 
_01900 _ 
"020aB C 

02100 

J2200 C 

023~0'0" C 
02400 C IBL = C5 
02500 C INTs? 



"~» » ••»"»» « # « » •»V«1» fl *«' ♦ i »"» « • F SP iS Afl P t, E a 3 • « « »V» » • » « » • * » » •"«»"•'» i» ■» » » « 

THIS PROGRAM IS A SAMPLE TEST PROGRAM THaT TESTS SOME 

'PEATUfiES 'OF^^TMrTcRTKAN -pACKAGr FSP iN"^0RCE:Fl^TO-"US!:~TRTS 

PROGRAM A SUBROITIME MUST EE WRITTEN TO cORRECTlY FORMAT THE 
TEXT AND OUTPUT THE ARRAY, THE CALLING SEflUENGE lS| 



CALL 



SETEXT< »AAAAAt| lA) 



C 

c 

_c_ 
c 
c 
_c 

c 
c 



WHERE I A rS AlTTrTTEGER CF TFE^roTAl^^^JMe?R"OT~CFAfi A-CTERS-ffrr^Jl^" 
SENT AND AAAAA IS 1 TQ A MAX OF 5 CHARACTERS SURRQUNDEQ BY 
SINGLE quotes; THIS EVOLVED FROM USE flN ThE FOP-ifl WHOSE 
'36 "91T WORD 'HCLCS 5'"A"SC l I~CHARACTERsr NoTF I ^TO'^SENCI li STRTTJTr" 
OF MORE THAN 5 CHARACTERS, HAKE SEVERAL CALLS OF 5 CHARACTERS 
EACH MTH IAS0. THIS WILL ADD EACH ADDITIONAL 5 CHARACTERS 

T 0~ T H E E MO "O F" A r~C U T P^T- A R R A 0 N " T H E "0 S f ~C A U r^tT-S E T EXT~ 

SET lA EQUAL TO THE TOTAL NUMBER OF CHARACTERS TO BE OUTPUT 
AND THE SUBROUTINE SEfEXT WILL MAKE THE CALL TO ThE SUBROUTINE 
'TEXf"lfr"HCP7 



DIMENSION ILENG<2} 
INITIALIZE PARAMETER VaUUES TO DEFAULT VaLUES 



NO BLINKING 
INTENSITY OF 

^~"rvT?0"irs-o"nD"i:TNE — 



B2700 C IN0=£5 • ALL INDICATORS 

02800 C 

imm (TTCsr^Eaf 

03000 C ICROTea 
03100 



SMA CtXST-CFArRTrC T E R S I-HE" 



~03ierr 

03300 
_03400 
0^ 
03600 
_03700 
0T8013' 
03900 
04000 

04200 
04300 

04500 
04600 

~0470E 
04800 

_04900 
05"fir00" 
05l0lS 
05200 

0^400 
05500 

~0?6"00" 
05700 
05B00 

"135^013" 

06000 



NO ROTATION OF CHARACTERS 
V ICSPACS10 " SPACING BETHEEN CHARACTERS ( IN OlfS) 



^ 

C ISPS0 « FAST DRAWING RATE 
C ISYNC=1 - 60 HZ 
"CnrPEW0"»~TTraTCrPET^S~tnTAIt'ED 

c 

C iLENGs LENGTH OP REFRESH PACES 



DATA IBL, iNTi iVT,lND/0i7i0il5/ 
DATA ICSIZEi iCRCTj lCSPAC/0i0ii0/ 

"DATT-rspTisYNCTrppf/f may ■ 

DATA ILENG/2?6|169/ 



FLAG IS AN INDICATOR SPECIFYING WWHETHCR 
THE TEXT 'TEXT' IS BLINKING OR NOT| 

rr PF L A^G = iST'lT-- 1 S - N C T"B L I N KTM? 

IF PFLACni IT IS BLINKING 



— ^ — T'FrAG-ni ^ ^ 

INITIALIZE FSP USING LOGICAL UNIT 
CALL GSS4{5,e,2> 



S WITH SERIAL INTERFACE 



SPECIFY 2 PAGES OF USER DATA ,EACH LENGTH BEING AS DEScRIBEB 

TN-THE" ' ILENG-I -DATA -STATK«ENT-ABOVC-| 

CALL LAYCUT«2,ILENGJ 



SPECIFY USER COORDINATE SYSTEM WITH LOWER LEpT 



E-10 



_ 06100 C AT (0..g'.') AND UPPER RIQHT AT <7ggn7ggV^ 

06200 0 

06300 CALL SCALE:{0,0|t3,f|700",0, 700,0) 

0640 0 C E NABLE PHQTQPEN 2 

06500 C 

06600 CALL ENBPEN{2) 

0670 0 C 

06800 C TURN ALL LAMP'S OTF OKn<|rYB'WfTD 

06900 C 

07000 CALL LAHP0F{4i»t? 
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__00tg0 __c__ _ 

0S20t3' '"C" ST ART AT BEGlNNrNG'CT PAC:r~r 
02300 C 
00400 C 

"'M^m C^THrs'TECTTOrTeBTS^lHET-VARIOfS-TTNt-Trprs 
0260(3 C 

0070g C 

0080a C DRAW BWOIR 
00902 C 

__0P0_0 CALU HOVE ( 100 . 1 100 1 1 0) 

0a'00~ CALL ORAt^(60Z,"ri0r,7in 

01200 CALL OPA^(0m100,i1) 

_0i3 0 0 C DR AW DOTTED LI NE 

"014130 C 

01500 C CALL STATUS TO CHANGE LINE TTPE 

J 1 6 0 0 , C IVTal S PECirUS DRAW DOTTEQ VECTORS 

01700 C ' ' 

01800 IVT91 

01900 99 CALL STATUS {IBLiINTi I VTilNO) 

"~0200"0~ cm Dfl7iWT^7730BT7TI 

02100 C SACK TO SQLIO 

02200 C CALL STATUS TO CHAWGE LINE TYPE 

"~02"3a"0 TriVTs0~SPrcrFTES--SCUO~T/|T^TORS- 

02400 C 

02500 IVTa0 

—02600 ^rrrasTi BCTTN t • i vt 1 1 nch — ~ 

02700 CALL DRAlN(600,|600;i0) 

02800 CALL DRA)n(«10I^ii0ii1} 

~~0"Z'900 c~DRAW tnrr»D7rsfl '. ~ 

03000 C ■' ■ 

03100 C CALL STATUS TO CHANCE LINE TTPE 

-~0T2B'r-~C~T?TB3-SPrarFTES DCT;D^S>rtT?^E 

03300 C 

03400 IVT"3 
~13W0 CATC STXTTJS-rrBiilNTilVTJlNUI 

03600 CALL DRAk<i300n0.ii) 

03700 C BACK TO SOLID 
— 0-3W0 C-CALL STATTJS-TC CHA WGnrl'NE-TYP E 

03900 C IVTsg SPECIFIES SCLIO VECTORS 

04000 C 

—13-4x00 rvTw0 

04200 CALL STATUSdBLiINTilVTilNDJ 

■ 04300 CALL DRAl»(10e,|600,,0) 

-— enr4UB ttaci: mrnKz-wtminVi 

04500 C DRAW DASH 

04630 C CALL STATUS TO CHANGE LINE TYPE 

u-47Er0 — c-iTr= 2-^ F r c r r rES"o a s h -ve cTtjns 

04800 C 

04900 IVTb2 

— 05-0F0 CALL— srA-rusriBL^tm-mtiN8i — 

05100 CALL DPAV.(0,i''300i|l) 

05200 C BACK TO SOLID 

— -053trr • — TTC AUTS T A TU S - T O-CH A NCr-trl N^-T YPE 

05400 C IVTS0 SPECIFIES SCLID VICTORS 
05500 C 

— 05-60r- Tirr»0 ^ 

05700 CALL STATUSdSLiINTiIVTilNOI 

05800 CALL DRAK(10e,jl00,|0) 

--05 9 0« CALL"" D R A K ( 0 1 1 0 I i 0 > 

0^000 CALL MOVE{?00||0nl» 
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06100 CkUk 09\^{6«^n%Z^\id)_ 

06200 CALL M0VE(6fKl| |600| |0) 

06300 CALL DRAV.{70lZi|7eE;,i0) 

06400 ^CALL ^H0VE(;7ea, |2, ,i) 

0 650 0 C All D fi A K "( i 0 i si 0 0 ',71]' 

06600 CALL MOVE(25e,,350,,0> 

06700 CALJ, DRAk(60iL0i ill 

0680ei CALL MO vn 390 , | 353, |0) 

06900 CALL DRA^{60,»0m1) 

07 000 C A L L H 0 V E ( 3 50 , 1 4 5^3 j jg) 

07100 CALL DRAi»(0',in60,,H 

07200 CALL MOVE(350,,3i(3',i0) 

0 730^ CALL ORAis{ 0 , . "§0 , i U 
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_00100 c _ _ 

02300 C THIS SECTION TESTS tHE VARIOUS CHARACTER S{Zi?3, INTENSITIES 

_J 0 4 a 0 C__A N 0 C HA SACTER R QTATlONt ^ 

00500 "C 
00600 C 
00700 C 

—00600 c~^TAR"tnriTHnwrmirvTCu^Trr^ 

00900 C ANO SPACING OF 10 DtTS 
01000 C 

~ 0"lT0 2 CAUt " C P"A?ffln C Sl-i ETTTCRO TTT^TS FACl ' 

01200 CALL MOVE(530,|10?,|2) 

01300 C ______ 

"01400 c NOW 00 swrTEiTT^sfriJEswFTToTifroi^rT^^^ 

01500 C 

01600 CALL SCTEXf{'SANDE«i0) 

01800 C NOW TEST ROTATE 

01900 C CALL CPARm TO CHANGE CHARACTER ROTATE 

—QWm ^c^cRo?=T""spEcrr"iES"wrA-TErcrAT^A"CTinr9r-or^^ 

02100 C 

02200 IC RQTgl . 

~TzzW^ c'Ain: JFATrpm^RrrTCRaTTT^sPAcJ 

02400 CALL SETEXT('ASSOCfi0) 

02500 CALL SETEXT! 'IATES»il0) . 

"OrcnrTESTTWR"CFARTCTE^~-SRES-S-tiDr5Ff(rrN ~~ 

02700 C CALL CPARM TO CHANGE CHARACTER SIZE 
02800 C ICSIiE=e SPECIFIES SMALLEST 

—0290-0 ^TTC-SRE^T^T'ETJTFIEr^TrXT-Tg-^mTrm- ~ 

03000 C ICSIHE=3 SPECITIES NEXT* TO LARGEST 
03100 C ICSIEE34 SPECIFIES LARGEST 

03330 C ICSPaC WILL BE CHANGE AS EACH CHARACTER SiZE IS CHANCED TO 
03400 C ALLOW FOR DECENT SPACING BETW EEN C HARACTgRS'.' ' 

~~4j'5m — C ^ ' ^ ^ 

03600 CALL MOVE (450, 1 6.05V 1 0> 

03700 C SET ROTATE OFF , CHAR H » SpAC JNG 1 30 

— ITSUia TCROTpU — 

03900 CALL CPARM(g,0,30> 

04000 CALL SETEXTCEX 

—^41130 C SET ffllin'3TSPT20 

04200 CALL CPARM{2,lCROTi?0) 

04300 CALL SETEXTl'EX 

~mTm C SET CH"ARI2iSFlT5 " 

04500 CALL CPARMdilCROTilS) 

04600 CALL SETEXTj'EX '131 

—^Jrm C SET CHAR1'1TSPT10 

04800 CALL CPARM(0, IQROTiiB) 

04900 CALL SETEXTCEX 'i3l 

— gfS 013 0 C PRTNT~TRE TIT L E ^ ~ ~ ^ ' 

05100 CALL MGVE{250ii51«Vi0) 

05200 C SET CHAfi|3iSP«20 

— 0 cstt CPA RwrrrrcR o Tjt 51^ • 

05400 CALL SETEXT{iGSS4 It0> 

05500 CALL SETEXTC TESTIil0) 

~W€m -HOVEr2-80TT^80Tr0l 

05700 CALL SETEXT{ «PROGR«i0> 

05800 CALL SETEXtPAM t,7> 

— 05'9"00~ C"TE5T~BR I GHTNCSS : 

06000 C CALL STATUS TO CHANGE INTENSITY 
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_12$100 a INTENSITY RANGES TRCH B TQ 

06202 C 0 IS INVISIBLE 

0(5300 C 1 IS VERY DIM 
_j! (5 4 0 0 C 7 IS THE BRIGHTEST 

06500 C 

0^600 CALL MOVE{110i |605i'J0) 
__06700_ . , PO__200 J''li7__^ 

06800 e CHANGE^INTENSltV T0~3 

06900 INTb8«.J 
_07000 CALL STATUSUB U tlNTilVTaNP) 

07100 C 

07?00 C WE WiLL CALL A ROUTINE JO CONVERT OUT INtErGpR »J' TO 
_0 7 3 0 0 C A N ASCII CHAR ACT EH WHI CH InE CAN DISPLAY flN Th Z SCREEN, 

07""400 C ' 

07502 C CALCULATE 7-BIT ASCII FOR INTENSITY NUMBER 

07600 !TXa48t»ai*J 

C CALL TEXT TO DISPLAY THE CHARACTER JUSt cOmPuTECi^E USE »TEXT» 
C RATHER THAN 'SETEXT! BECA(jSE THE CHARACTgR IS SET Up IN THE 

"C'llTT E G ER" A R R A"r"P R OF-ERtV^ACR U^T, 
C 

CALL_ TEXT(iiITX> 

08300 200 CONTINlJE 
0S400 C TEST BLINK 

08500 C CALL STATUS TO CHANGE JUNK 



08600 
08700 
08800 


C 
C 

c 


IBL=£ SPECIFIES BLINK 




08900 
09000 
09100 


c 


TURN BLINK ON.SET JKTENtilTY TO 7j 
CAUL CPARMiSi igROTi30-1 
INT«7 


CHARi4:SPi3ia 


09202r" 

09300 

09400 




CALL STATUSdBLiINTilVT, 
CALL M0VE{325, 1335,10) 


INO) 


09600 
09600 
09700 


c 


CALL SETEXT{'U7li2) 
TURN BLINK OFFI SET CH AR } 1 i §P 110 
CALL STATUS TO TURN BLINK OFF 




09800 
09900 
10000 


c 
c 


TBLi?0 SPECIFIES NO BUNK 
I0Li»0 




1010fe3 
10200 




CALL STATUSJIBLilNTilVTi 
CALL CPARM«lCSl?£,JCROTi 


INUJ 
ICSPAC) 



07700 
07800 

J7i0L 

08000 
08100 
08200 



002012 C~l=*rGrTTC0T^TT^DR"ATr"FOITrT CTRCtT" 

0230^5 C THIS SECTION DEMONSTRATES THE USE OF SUBROUTINE PCINT 

0 2 2 0_ C ME Hit L DRAW A CIP CLE C O NSISTING OF g4 PqInTS 

00 500 ' C 

00600 C 

00700 DQ 100 !'jli24 

0"{180^I ' C 

00900 C WE 00 SDHE ARlTHEf'ETlC QOMPyTATIONS TO CflHPUtE XiY VALUES AT 

tlB 0 0 C WHICH WE WILL DRAh A POINTi 

'01100 C 

01200 ANGLEs{ (1«15. >/18B,)«3,l4159 

0130 0 __XPTB350,*10e,«CCS(ANGUEJ 

"014 00 Y P f = 3 5 0 r* 1 0 e V » S I N ( A N G L E > 

01500 C DO A MOVE TO THAT Xj ANQ Y AND PLOT A POINT,' 

01600 CALL HQVE{ XPT,YPT»g) 



0170"0 CALL POIN^ 

01800 C 

ri900 C 00 FO R ALL 24 POINTS 

0 20 0"0 C 

02100 100 CONTINUE 

02200 C END OF PAGE 1 
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001012 


00200 


c 




00300 


C 


PAGE 2 


00400 


c 


THIS SECTION GENERATES GRAPHIC DATA ON PaGe 3i THIS PAGE WILU 


' 00500 


c 


THEN BE CALLED BY PaGE 1 SHOEING SUBRquT f NfTI NKAGES", NOTr"THA.T 


00600 


c 


PAGE 2 WILL NOT BE DJSP1.AYED UNLESS AND uNtIl PAGE 1 CALLS IT, 


00700 


c 




00600 


c 




00900 


c 




01000 


c 


OPEN PACE 2 fOR DATA 


01100 


c 




01200 




CALL A0DREr<2i 


01300 




CALL MOVE{34g7il40Vi(i'l 


01400 


c 


SENSITIZE DATA TC PHOTQPEN 


01500 


c 


WE WANT TO USE THE PHOTQPEN TO MAKE THE fEXT 'TEXT' IN THIS 


01600 


c 


SFCTION BLINK OR NOT BLINK ON COMMAND, Wf MUSTi ThERFQRE 


0 J700 


c 


SENSlTiifE"THE DATA' STWANT'l^L DO THAT By CALLINC 


01600 


c 


DPARM WITH A PARAMETER fPECIPYING ENABLE PWOtPEN 2 


0l900 


c 




02000 




"'CALL DPaRM( ISPi ISYNC»2) 


02100 


c 




02200 


c 


NOW WE KANT TO KEEP TRAQK OP THE DATA WORD TmAT CcNTRQLS THE 


02300 


c 


BLINK, TO DO THIS WE REQUEST THE MAHK OP ThE NEXT AVAILABLE 


02400 


c 


LOCATION INTO WHICH WE HILL PUT THE CALL To sTaTUS TO CONTROL 


02500 


c 


THE BLINKING! 


02600 


c 


CALL REQMRK DOES THIS 


02700 


c 


NEXT CALL EVENT TC SEE IF THE DATA IS REiOY fO BE SfNT TO US; 


02800 


c 


CALL EVENT (l) DOES THI§ 


0290'0 


c 


IF THE EVENT SPECIFIES THAT IT HAS A MaRk RESPONSE, 


03000 




CALL GETMARK TO RETRIEVE ITV " 


03100 


c 


CALL GETMARKUNAL) DOES THIS 


03200 


c 


SAVE THE MARK FOR FUTL'HE USE TO UPDATE THE BLINKING 


03300 


c 


CONTROL WORD, 


03400 


c 




03500 




CALL REQMRK 


03600 


10 CAUl EVENT(l) 


03700 


c 




03800 


c 


ir Is7i THEN EVENT HAS A MARK RESPONSE; oThErWISE 


03900 


c 


GO WAIT FOR IT, 


04000 


c 




Ci4 1 00 




IF (I VneV 7) go to 10 


04200 


c 


EVENT SAYS MARK RESPONSE READY, GO GET MXRK 


04300 




CALL GETMRKCINAL) 


04400 


c 


INAL WILL BE USED LATER FQH UPDATING 


04500 


c 


PUT In BLINKING CCNTROL WORD TO BE ALTERED 


04600 


c 


IN RESPONSE TO PHCTQPEN STRIKES, 


04700 




CALL STATUS(IBL»INT,IVT,IND) 


04800 


c 




04900 


c 


THIS IS THE TEXT THAT WILL BLINK 


i^m 


c 




05100 




CALL SETEXT (ITEXT»,4) 


05200 


c 




0T400 


C 


IS SENSlTIiED, 


05500 


C 




05600 




CALL DPARH(ISP,ISYNC,0) 


" 0 5713 0 


C 




05800 


C 




05900 


c 




0T0'0'0^ 




NOW MOrrfY^P'A'GEr'l TO-"CA-tr"FAGE 2 


06100 




CALL AODREFUJ 



E-17 



06200 

'0430^ C 
06400 C 
06500 C 



06600 
06700 

_06600 
06900' 
07000 
07100_ 
07200 
07300 

j)74 00_ 
07 500 
07600 
07700 

"■07e0F' 

07900 

_0a000 

08l¥0' 
08200 
_0_8300_ 
■ 0a"40'0 
08500 
03600 



NOW WAIT FOR PHQTOPEN STRIKE AND G£;T iNrORHiTlCN 
IT OR Fb R " rUNCT 1 0 N K E Y""3 FT 0 "T X R 
C 

_C 

20 
C 

_C_ON_RETURN_IF l!:4, THEN THERE MAS A KEYBOaRQ STRIKE 
C CiO'"GEt KEYBdARD DATA 

C IF Ib5i then THERE kAS A PHOTOPEN SfRlKEl 60 GET DATA 
C OTHERWISE, GO WAIT FOR ANOTHER EVENT 



"cAXinyENTTTy 



08600 
08900 

"09e'0B' 

09100 
09200 



IF U ,EQ', 4) GO TO 101 

IF (I .NEV 5) CO TO 20 

"C GOT PHCTOP'EN'"stRrKET~Gg GET~TJAT* 

CALL GETPEN(lpEN,IMPAGEiMARK,ITYPE:icPAGE,IeYTE,lTMNUMJ 
C THIS INFORMATION CAN B|: USED FOR VARIOUS PURPOSES, THIS TEST 
ir~FR OGRA H' "I S~1I0T~C OTIC Ef^E P-Wl T H-THTTJ A T A" aWo"" n 0 E S^KOTH lTJ5-irrTir- 
C IT, TO ACKNOWLEDGE THAT WE GOT A PHOTOPEN STRIKE, THOUGH, 
C 'TEST' KILL BLINK OR NOT BLINK, OEPENoiNe ON PRESENT STATE, 
ir-fT^P FTA CWr 'T TT~TS"NO T-BL~n^KTl^ GF GO"Bn NKTT 
C IF PFLAC=li 'TEXT' IS BLINKING, 60 STOP BLlNklNC 



IV (PFLAG ,EQ'.' 1) GC TO 3ia 
PFLAG 3 I 



"0931^0" 
09400 
09500 

09600 
09700 
09800 



"rTlXTOt R~ffORa~CWlTRUlXI NG-iU^KIN G7^ 

C WHERE 2 SPECIFJES.PAGE 8 ANP INAL SPECIFIES THE MaRK Of 
C THE DATA WE ARE GOING TO CHANGE, 



CALL UP0ATE<2;iNAi.) 



z ALL UA T A i ^ow WILL g r^cirrcR E P ON P AGS StA T?TtWr 

C AT MARK iNAL. 
C 



Tf-ms CALL STATUS (jl, INTi IVT, INO) 

10000 GO TO 20 

10100 C 'TEXT WAS BLINKING, STOP BLINKING NQW 



TFLAG s W 



10'2W 
10300 C 

10400 C TO ALTER WORD CONTROLLING BLINKING, CALL UPDaTE( 2, iNAL) 

315500 — irTfflrKir2'~sprcrrrEs-T»7i"Gri?^Nirn'iTAt-^ 

10600 C THE DATA WE ARE GOING TO CHANGE', 

10700 G 

CflnrUPOTTETTSTTNAtT 



10900 
11000 



11200 
11300 

11500 
11600 



CALL STATUS ( IBLi INT, I VT, INO) 
GO TO 20 



T17U0" 

11800 

11900 

12102 



C EVENT SAYS WE GOT A fUNCTlQN KEY HIT 
C 

"irorGErroTJcT I t)rrxcY-mj m Brr-A«trTEST~f ufn^nrTo^trrr 

101 CALL GETKEY(KBO,KKY) 

IF (KEY ,NE, 31) go TO 20 



C IT WAS FUNCTION KEY 31, SHUT OFF DISPLAY AnO RETURN TQ 
C TTY EMULATOR', 

"C ^ ' 

CALL THEEND 
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00100 c 
00300 C 

00 400_ _C SUGROUTj NE TO Pll TE XT R I GH T AOJUS TED fN 5;0 ARRAY 

01Z500 ' C " " ' " 

00600 C THIS SUBROUTINE 5ETEXT IS USED TO SET THE ARRaY FOR TEXT 



00700 C IN THE FSP ATP, TE.XT IS TRANSMITTED IN aN ARRAY WITH ONE 

~0 0 8 0 0 ~~C 7 B I T A S C 11 C H A R A C T E R r P I G H T A D J U S T E Of" I N "f A C R-EUE HEN TV 

00900 C MOST OF THE TEXT IN THE FSP ATP IS CiLLEn US!>G SETEXT 

_0jLe00_ C THE FORMAT__ISi_ 

0liP C --^^-^^-j^- - — SEfEnTTAAAA'AMXJ 

01200 C WHERE lA IS THEToTAU NUMBER OF CHARACTERS AND AAAAA IS 1 TO A HAX 

__0i300_ C OF 5 CHARACTERS SuRROgNQEp BY_SINGl.E GlJOTEfSi ThiS EV01.EO FROM 

0'i400 C THE" PDPb£0 WHOSE^ 36 8rT"W0RDS HOlD TlsCTrCHTRACTETRS'; TO^SE^SO 

01500 C A TEXT STRING OF HORE THAN 5 CHARACTERS. MaKE SEVERAL CAUUS 

01600 C OF 5 CHARACTERS EACH WITH IA=0, THIS WILL ACO 

~0T7 0"0~C~T HE" 5"""C H A R AC T E R S T 0 ~TFE~E ND-Or^-A'N ~A R RA y7 orTH E-CTSnTAT^C 

01800 C TO SETEXT, SET I A EGUAI, TO THE TOTAL NUMBER OF CHARACTERS, 

01900 C SETEXT DOES THE ACTUAU CAUL TO THE TEXT SUbROLTINe IN HCP 



02000 
02100 
02200 


C 

c 


SUBROUTINE SETEXTdWROi ! A) 


02300 
0240^ 
02500 




DIMENSION IaRRaY(&J|IA«YU00> -^'^ 

DATA IAD/1/ 

IWCRO=IWRD 


0260^ 

02700 

02800 


C 
C 


ITEST=IW0RD 

THIS MOVES THE 5 ASCII CHAR 1 BIT TO ThE R!GHT TO MAKE 


02900 
03000 
03100 


C 


IT RIGHT ADJUSTED 

IW0RD = IWORD/2 - ■ 


0;3r2'0ir^ 

03300 

03400 


c 


TF"nfHHST~q-aE'S FROM S TOT^ETCAUSg THAf IS THE CRoER THf — 
CHARACTERS ARE RETRIEVED FROM IWORO 
00 100 1^1,9 


03500 
03600 
03700 


""■""C " 

c 


TAKE THE 7 RIGHT BlTS| THE" NEXT CHARACTER 
IARRAY{6»nslW0RD,ANP,«177 


03800 
03900 
04000 


c 


ITEST-IWOHD 

SHIFT IWORO RIGHT 7 BITS TQ GET THE nExT CHAR RIGHT ADJUSTED 
IWCR03lW0RD/(2*»7) 


04100 
04200 
04300 


c 
c 


THE PCP-10 TRUNCATES, 50 CONTINUE IF IwORD IS PcSlTlVi 
IF( IWORO. GEVOGO TQ 180 


04400 
04500 
04600 


c 
c 


IF IWORD 15 NEGATIVEiMAKE SURE THERE ISNtf A TRLNcATlON ERROR 
iFdTEST.NE, IWCRD«<2»«7) ) IWORO'?! WORO"i 


04800 
04900 


c 
c 


C-QNTTNUE 

TRANSFER THE ASCII CHARACTERS TO THE OuTpUT ARRaY 


^5F00~~ 

05100 

05200 




00 101 JsliS 

IARY{lAD)slARRAY(J) 

lADtlAO*! 


"155300 
05400 
05500 


101 

c 

c 


CONTINUE 

IF THIS IS JUST AN ADDITION- TO THE OUTPUT ARRAY, RETURN 


0"5~60ir- 

05700 

05800 


c 
c 


IF(IA,EQ.0) RETURN : - 
RESET IAD TO THE STAR? OF THE OUTPUT ArRaY 


■T59izr0~~ 
06000 


c 


lAOPl 
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.fl610E 5 i£ND 5UT_TEXT__ 

06200 CALL it)ifVU\\m) 

06300 RETURN 

06400 EJiO ^ 

06530 C 
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EXAMPLE 4 



This sample program illustrates FSP subroutine CLIP. The data base and its 
relationship to the user defined coordinate system are shomi in SAMPLE 4 - PICTURE 1, 
The actual displayed picture after clipping is shown in SAMPLE 4 ~ PICTURE 2. 

After picture is displayed, to return to the TTY emulator ^ hit upper right 
most function key. 
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(USER DATA BASE) 



(USER DEFINED COORDINATE SYSTEM) 



1000.,1000.->^ 



800., 800. 




SAMPLE 4 - PICTURE 1 



This diagram shows the data points in the USERS DATA BASE in relation to the 
user defined coordinate system. Picture 2 shows how the display will look with 
clipped data. 
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PET 




SAMPLE 4 - PICTURE 2 
This is what the final display will look like with data clipped. 
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00100 c 

00201^ C »»o*<nnta»»«»»»»«ft«o'««»«« FSP SAMPl,£"4»«'»»**»«»fl»«»»««»«»»*»<t»<m««4»» 

0Z30B C 

70400 C THIS PROGRAM IS A SAMPLE PROGRAM THAT TEsTs THE FSP 

C SUBROUTINE CUIP, 

00600 C 

00700 C THE USCRS COORDINATE SYSTEM IS DEFINED AS ( 2fi0. 1 220 ,) LOWER LEFT 

0ee0fi c AND (8C5eViB00', ) UPPER right; 

0290? C X ANO Y DATA RANGES FHOM (0,,0,)LOWER LErT TO (1000', , , ) 

01000 C UPPER RIGHT, 

ellfllf C EACH SET OF DATA POINTS IS FED TO SUBROUTINE CLIP, 

01200 C CLIP PASSES BACK PARAMETERS TELLING THE uSpR WHETHER 

(11300 C THE POINT WaS ON SCREEN OR OFF OR PART On AND PART CFF.ANO 

01400 C WHETHER TO 00 A ^0VE:,0R A DRAW OR A MOVF ANn OPAV> TO CREATE 

01500 C THE DESIRED CLIPPED PICTURE, 

01600 C 



01700 DIMENSION X(a)iY<§l 

0l800 QATA ILENG/1000/ 

01900 C 

02000 C DEFINE OUR DATA BASE OF X ANP Y POSITIONS 

02100 C 

02200 DATA X/0.;ie0Vi250Vi500,,650,i900V/ 

02300 DATA Y/0,i350;i450,,30e,,100,,500;/ 

02400 C 

02500 C 

02600 C INITIALIZE AND USE UCGJCAL LNIT NUMBER 5, TRANSMISSION 

02700 C WILL BE OVER THE SERIAL INTERFACE 

02800 C 

02900 CALL GSS4(5i0;g) 

03000 C ■ , . 

03100 C SPECIFY i PAGE OF USER PATA IILENG' IN LfNGTh WHiCH IS 1000 WORDS, 

03200 C 

03300 CALL LAYOUTdi ILENG) 

03430 C 

03500 C SPECIFY THE USER COORDINATE SYSTEM TO BE (20C!,,20e,> AT LOWER 

03600 C LEFT CORNER AND (800, ,800.) AT UPPER RIGHT CflRNER, 

03700 C 

038B0 CALL SCALE{200,,200,,900;,800,) 

03900 C 

04000 C OPEN PACE 1 FOR TCP LEV|L DRAWING 

04100 C 

04200 CALL ADDREFtl) 

04300 C 

04400 C IOP=i SPECIFIES TO SUBROUTINE CLlPi THAT THE POINT WE ARE 

04500 C PASSING IS THE INITIAL >(|Y DATA, 

C14600 C XI AflD Yi ARE INPUT AS THE NEW BEAM P0SlfInNlX2 AND Y2 ARE NOT USED',' 

04700 C XP0SF3 AND YPOSB KEEP THACK OP THE CURRENT REaM POSITION,' 

04600 C AND SHOULD BE THE SAME TWO VARIABLES ON PACH CALL Tq CLIP. 

04900 C THESE ARE NEITHER SET NOR USED BY THE uSpR'.' 

05000 C 

05100 lOPPl 

05230 C INITIAL POINT 
05300 Xl^Xll> 
05400 Y1=Y<1) 

C15500 CALL CLIP{ICP;xliYl,X2,Y2,200,,20B:,fl0(ii,,e0e,,XPoS8,YPOS9j 

05600 C 

05700 C ON RETURN, IF lOP'Sl THE SPECIFIED POINT IS nFF ScREEN, QO NOTHING 

05800 C IF I0Pa7» THE SPECIFIEU POINT IS ON ScREfN'." THE USER 

05900 C SHOULD THEN CALL MOVE U§ING XI, Yl 

06000 C 
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IF(I0P,EQV7)CAI.U MOVE{n.Yl,0) 

06200 , C 

06302 C NOW DO REST OF POINTS 

064012 C 

B650I2 DO 100 Ifi2,6 

06600 C 

06702 C I0P = 2 SPECIFIES ANY POINT OTHER THAN THE INItUL FOiNT 

06802 c X2 AND Y2 ARE INPWT AS THE FINAL POSITION OF A VEcTcR TO 

06900 C DRAWN FROM THE CURRENT POSITION, 

07000 C NOTE THAT WE MUST USE THE SA^'E XPOSB AND YPOsB AS IN THE INJTaIU 

07100 C CALL TO CLIP'. - 

07200 C , 
07300 lOPa2 

07400 , x??xn) 

07500 Y28Y(I) 

07600 CALL, CLIP{ICP;XliYl»>!?iY2,200M2007.80eii;e0ei,XPOSS,YPOS9j 

07700 C 

07600 C ON RETURN, IF I0Ps8 THE ENTIRE VECTOR iS OFF SCREEN 

07900 C DO NCTHIN5, 

08000 C IF I0P=7, THE START POINT OF THE VECTOR iS ON THE ScHEEN',' 

08130 C CALL P«AW USING X2 AND Y2 

08230 C IF IOP = $i THE START POINT WAS OFF SCREEN'.' 

B8300 C FIRST CALL MOVE TO MQVE THE BEAM TO X t , YlC • .' THa T IS RELOCATE 

08400 C START POINT TO WHERE VECTOR COMES iwTn USrR COCRqINaTE RANGE 

08500 C THEN CALL DRAW TO DRAW A LINE TO X2 AnO Y2i 

08600 C 

08700 IF{I0P,EQ','8)6C TO 100 

.08800 IF( I0p,EQV7)GC TO 50 

08900 IF{IOP,NE;9)00 TO J00 

09000 C . 

05100 C ON RETURN 1 0P=9. SPEC IF Y JNG THE START poiNiT IS OFF ScREEN 

09200 C 00 A CALL TO HOVE WITH XI, Yl ANQ A CALL fO DRAW WITr X2,Y2 

09330 C 



09400 CALL MOVE(XliYli0> 

09500 CALL DRAW{X2iY2,0J 

09600 C NOW GO GET NEXT POINT 

09700 C 

09800 GO TO JL00 



09900 C 

10000 C ON RETURN 10P57 SFEClPYINC THE START POImT Op THE VECTOR IS 

iei00 C ON SCREEN, .,, 

12200 C DO A CALL TO DRAW WITH XZ|Y2', 

10300 C 

ll?400 53 CALL ORAW(X2iV2i01 

10500 C 

1E600 C NOW GO GET NEXT POINT 

10700 C 

10800 100 CONTINUE 

10900 C 

11000 G WHEN ALL DONE DRAHNG.WAST FOR FUNCTION kEy NUMElii 31 TO BE HIT? 

11100 C THEN SHUT DOWN DISPLAY AND EXIT 

11200 C 

11300 C , 

U400 C FIRST CALL EVENT TO SEE IF THERE HAS BEEN ANy KEYEOaRO INPUTT 

11500 C 

11600 1?0 CALL EVENTdli 

11700 C IF If 3 4, THEN A KEY WAS HlTi GO RETRIEVE If, CTHER WISE 

11800 C WAIT FOR ANOTHER KEY STRIKE 

11900 C 

12000 IF(H.NE,'»)G0 TO JLSe 
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12100 C CALL GCTKEY TO FIND OUT WHAT KEY WAS HIT 

12200 C 

123013 CALL GETKCYtKBO.KEV) 

12400 c IF It WAS KEY NLHER 31, THEN EXJT, OTHERWISE GO WaIT FOR 

i25J30 C ANOTHER KEY STRIKE, 

12600 C 

12700 1F{KE:y,NEV31)G0 TQ 150 

128012 c 

12500 C IT WAS KEY 3i, SO SHUT DOWN niSPLAY AND pXiT TO THE TTy EMULATOR 

13200 C 

131(30 CALL THEEND 

13200 END 



EXAMPLE 5 



This sample program illustrates the use of FSP subroutine SMOOTH. EXAMPLE 
PICTURE 1 shows the displayed data before smoothing. EXAMPLE 5 - PICTURE 2 shows 
the same data displayed after smoothing. 

To return to the TTY emulator after the picture is fully displayed, hit the 
upper right most function key« 
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EXAMPLE 5 - PICTURE 1 
DISPLAYED DATA BEFORE SMOOTHING 



EXAMPLE 5 - PICTURE 2 
DISPLAYED DATA AFTER SMOOTHING 
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0Bl0a __C»» »_»*»»»«• «*♦»«»« i FSP S AMP 1.E go '» » a 

02306 C THIS SAf^PLE PROGRAM ILLUSTRATES THE USE oF SUBROUTINE SMOOTH 

004130 C 

025 02 T H r D A TF 8 AS E"'C 0 N S I S T S-Or-XTT~DIT"A~US E [^"(rTo RH^CR-APR; 

0eA0C C EACH DATA POINT WILL BE FED TO SUBROUTINE SMoOTh 
02700 C AhJO AN ALOGRITM WILL DETERMINE WHICH POInTS OF 

" 0 0800 C~T H E D a T A~ C a N " B E"DR A ysN ^K E E P I NG-R I TR- 1 N "T Hf T I'M ITS 
012900 C SET OY A DEVIATION FACTQH FED TO SMOOTH, 
01000 C PARAMETERS RETURNED INSTRICT THE USER IN WHAT USCfi 

-01100 iTR OU T I NFS" T^I"C A^TTTHAT~^§~7W^^^ET^T-D-C AtTTTiOi^^ 

01200 C ^lERFORM NO OPERATION'i 

0130 0 C 

0i'400 C 

01500 C THE DATA BASE CONSISTS OF 10 X|Y POINTS 

01600 C 

-0-1700— ■ nl"R E>1 S ION X a 0~)7T{Tr> ' 
01800 C XSAVE AND YSAVE ARE ARRAYS USED TO BUFFER DATA POINTS 
01900 C 

-¥a0'00 D rn ETTs ro"fnfsnTET50 j , y s a v e ( sm 

02100 C ILENG IS THE LENGTH OF PAQE 1 

02200 C ^' 

02300 OATTTirENGTl^e^/ 

02400 DATA X/256. i275, i280, ,512, i570,',60C!l. l7Aa. »86S. i900Vil000',J' 
_ 02 5 0 0 DATA Y/256. ,260. 1 285 . ,350. ; 34^;. 350.; 256., 260. » 265; #350/ 

026l3'0 C 

02700 C INITIALIZE, USE LCGICAL UNIT NUMBER 9', TRAnSmISIOK 
_02e00 C HILL BE OVER THE SERIAL LINES 

¥29¥0 C 

03000 C SPECIFY ONE PAGE- 12^00 WORDS IN .iENGTH 

03100 C SPECIFY USER COCRCINATE SYST E M AS 0,,0'.' L'OwER LEFT 

-0:j2"0 0 CT023 : . 1 1 2yrW"PrR R I OH r 
03300 C 

03400 CALL GSS4{5,0;2) 

CSti:-T""A"YOUT(i; ILENG) 

03600 CALL SCALE:«e,,0,,lB23,il023,) 

03700 C 

~"07I"^e C~rT^MlALLY SffUOTH IS CALLED WITH lOP^l'. THIS iNlTTAliTttS 

03900 C THE SUBROUTINE, X AND Y ARE NOT U3E0 

04000 C 

"T^IU^ FDR INITIALUATION 

04200 lOP » 1 

04300 XX»!0V 

04401Z TfP'Wx 

04500 C CAUL TO SMOOTH FOR INITIALIZATION 

04600 CALL SMOOTHt ICP, XX, YY, ISAVE, XSAVE, YSAVE,5ei20',' 

~ 0"4"7^ 0 C^Naw-STA'^r "S M 0 OTFIN C~ FCK-D"ATA""BAS t 

04800 C 

04900 C DO FOR 10 DATA POINTS 

—^Ym uo 100 I = 1,10 

05100 C X, AND Y DATA ARE FED TO SMOOTH WITH I0Pa2V 

05200 C THIS INFORMS SMOOTH THAT THJS IS A NEW DaTa POINT, 

-0510 0 — [r~xx7TY^~TS-THr"NEnr" c-A"T ansT 

05400 XX = XH) 

05500 YY » Yd) 

~ir5-6 0t! r aP"'"^ ' 

05700 CALL SMOOTH< ICP.XXiYY, ISAVE,XSAVE,ySaVP,52,20,) 

05800 C ON RETURN IF I0Fr4, THEN THE USER SHOULD TaKF NC ACTION 

-^5-9-00 — j-rF-rop=5T-c-AU"HovE-Tc-novE-THr-BEAM-TD-xxryY 

06000 C 
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_0$1B0 C !F I0pe 6 CALL DRAt^ TO XX, YY 

062013 C 

06300 C NQTEi THE XX AND YY R^TURNEP WILL NQT BE THE SAfC AS THE 

0640 0 c ON ES JUST passed ; 

06500 IFHOP ,EQ, 4) GO TQ 100 

06600 iFdOP .EQ. 5) CALL f-O VE < XX , YY , 0 ) 

_J 6 7 0 0 IF ( 1 0 P J E G_L_6 J CALL OR AW(XX ,YY;0) 

06600 C CbNTfNUE FOR" ALL CAfA POINTS 
06900 100 CONTINUE 

07000 £ 0A1A_J^ AH._DOME,_NCW_ptEAN yP_W I THL F I NAL CALL TO Sk OQTB 

07100 ' c"Th IS CALL fsTECEsTARYTQTo'Rce ouf The Last poTirr 

B7200 C 

073 00 C_THIS_F1NA_L call TO SMCPTH IS DONE WITH IflPag TO 

074¥0 C SPECIFY "LINE ENCT, 
07500 C XX AND YY ARE NOT USED 

07600 C , 

07700 lOP 3 3 

07800 C ■ CALL SMOOTH AND DRAW LINE 

07900 _CA L L_S M 00 TH ( 1 0 P i X X i YY 1 1 SAVE , XSAVE t YSaVEi 52 » 20V > . 

08000 CALL D^AW(XX,YY,0} 

08100 C 

08200 C NOW WE ARE DONE WITH PICTURE', 

~083P cn^O"TxTT~B^ACKnfO'n'HE~TT^-ERUl.lk^ 

08400 C BE hit; 

08500 C ______ 

"T8602 CFIRST CALL EVENTnrB~SE:En^^~WRE~FS^rEirANY KEYBTrWTTRmJTT 

08700 C 

08800 150 CALL EVENTjin . . 

--0-S9l3"0 C IF II a-"4— THETrrT^ETn^T^TirrriTinrHCT If, C'tHER Wl$f — 

09000 C WAIT FOR ANOTHER KEY STPIKE 
09100 C 



0-<r2ira- iF(ir,Nr,4)Go to m 

09300 C CALL GETKEY TO FIND OUT WHAT KEY WAS HIT 
094 00 C 

■Mfm " "eJLT^GFTKETTKITJTRm ~ 

09600 C IF It WAS KEY NUMER 31, THEN EXIT, OTHERWISE 50 WaIT FOB 

09700 C ANOTHER KEY STRlKEj 

09800 C ' ^ 

09900 IF{KEY,NEV31)G0 TQ 150 

10000 C . . , ^ 

TFT^B C IT WAS KtY 3i, SO SHUT-ODWN D ISPLAY -SW-fXtT-TO T|.E TTY-tnULATORV 

10200 C 

10300 CALL THEEND^ 

END ^ 
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APPENDIX F 



PRODUCT PERFORMANCE REPORT 



Occasionally 5 problems may be encountered in the use of products delivered to 
our customers. These problems or errors should be identified and communicated to 
Sanders Associates, Information Products Division by means of a Product Performance 
Report (PPR). 

Product Performance Reports should be submitted to Sanders Associates, An 
appropriate specialist will review your PPR and attempt to resolve the problem or 
offer a temporary circumvention. 

Every PPR is acknowledged upon receipt and answered in writing. 

In preparing a PPR, the following guidelines should be followed for accurate 
and timely service to your problem. 

1. Give as complete a description as possible of the problem encountered. 
Often a detail that may seem irrelevant will give a clue to solving 
the problem. 

2. If possible, isolate the problem to a small example or procedure. 
This will make it easier for the specialist to duplicate the problem. 

3. Include whatever documentation is possible, i.e., program listings, 
computer output or sample input. Annotations in a listing pointing 
to the error are very helpful. 
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PRODUCT PERFORMANCE REPORT 



Page 



of 



Submit To: 



CDMO 

INFORMATION PRODUCTS DIVISION 
SANDERS ASSOCIATES, INC. 
DANIEL WEBSTER HIGHWAY, SOUTH 
NASHUA, NEW HAMPSHIRE 03061 



PPR #: 

(assigned by the PPR center) 



Product Identification and Version 
(or document) 



Names 
Company: 

Address: 



Phone ; 



Zip: 



Operating System & Version 



Date 



Report Type 

□ Logic error 
O Documentation 

□ Suggestion 

□ Inquiry 



Priority 

□ Low 

□ Standard 

□ High 



□ Software □Firmware QHardware 
Is the problem reproducible? 
□ Yes □No 



CPU: 



Host~G7 interface: 



Attached documents: 



Distribution media: 



Description: 



PPR Center use only 



Date received: 


Date resolved: 




To specialist: 
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THE INTENT AND PURPOSE OF THIS PUBLICATION IS TO PROVIDE ACCURATE 
AND MEANINGFUL INFORMATION TO SUPPORT EQUIPMENT MANUFACTURED 
BY SANDERS ASSOCIATES, INC, YOUR COMMENTS AND SUGGESTIONS ARE 
REQUESTED. 

PLEASE USE THE FORM ON THE REVERSE SIDE TO REPORT ANY PROBLEMS 
YOU HAVE HAD WITH THIS PUBLICATION OR THE EQUIPMENT IT DESCRIBES. 



FOLD 



FOLD 



BUSINESS REPLY MAIL 

NO POSTAGE STAMP NECESSARY IF MAILED IN THE UNITED STATES 



Postage will be paid by 



Sanders Associates, Inc. 
Information Products Division 
Daniel Webster Highway South 
Nashua, New Hampshire 03061 



FIRST CLASS 
PERMIT NO. 568 
NASHUA, N.H. 



ATTN: DEPARTMENT 1-2894 (NHQ 1-447) 

""fold ~ "fold 



A 



SANDERS 

ASSOCIATES. INC. 



Name:_ 



Cdmpany:_ 
Address: 



Telephone 
Date: 



Description of problem (or suggestion for improvement): 



Sanders Equipment. 
Part Number 



Software/Firmware System. 
Version 



Host computer. 



Host operating system. 



Version 



Host-GRAPHIC 7 interface 



My problem is: hardware □ software □ 
firmware □ manual □ 



I 



i 



I 



Related tech manual number 



1 



